L_InetServerInit
#include "l_bitmap.h"
#include "ltnet.h"
L_LTNET_API L_INT L_InetServerInit(nPort, phComputer, pfnCallback, pUserData)
L_INT nPort; |
/* port on which to listen */ |
L_COMP * phComputer; |
/* address of variable to update */ |
INETCALLBACK pfnCallback; |
/* pointer to a callback function */ |
L_VOID *pUserData; |
/* user defined callback data */ |
Sets up a port to act as a server to which other computers can connect.
Parameter |
Description |
|
nPort |
Port number on which to listen for incoming connections. Some commonly used values include: |
|
|
Value |
Meaning |
|
0x015 |
FTP |
|
0x050 |
Web server |
|
0x077 |
News |
|
0x019 |
|
|
0x017 |
Telnet |
phComputer |
Address of a variable to updated with the handle to the server computer |
|
pfnCallback |
Pointer to a callback function of type INETCALLBACK for receiving messages for phComputer. Use the function pointer to your callback function as the value of this parameter. |
|
pUserData |
Void pointer that you can use to pass one or more additional parameters that the callback function needs. |
|
|
To use this feature, assign a value to a variable or create a structure that contains as many fields as you need. Then, in this parameter, pass the address of the variable or structure, casting it to L_VOID *. The callback function, which receives the address in its own pUserData parameter, can cast it to a pointer of the appropriate data type to access your variable or structure. |
|
|
If the additional parameters are not needed, you can pass NULL in this parameter. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
This function returns immediately, and the INETCALLBACK function will be called when other computers attempt to connect to phComputer.
You must initialize the LEADTOOLS Internet DLL using L_InetStartUp before calling this function.
Required DLLs and Libraries
LTNET For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application |
See Also
Functions: |
L_InetConnect, L_InetClose, L_InetAcceptConnect, INETCALLBACK, L_InetStartUp, L_InetShutDown |
Topics: |
Example
static L_INT EXT_CALLBACK InetCallback(L_COMP hComp, L_INT nMessage, L_INT nError, L_CHAR *pBuffer, L_SIZE_T lSize, L_VOID *pUserData); /* you do not need to use MakeProcInstance for 32 bit applications */ L_INT InetServerInitExample(L_COMP hServer /* the handle to the server */) { L_INT nRet; nRet = L_InetServerInit(1000, &hServer, InetCallback, NULL); if(nRet != SUCCESS) { MessageBox(NULL, TEXT("The server failed to start!"), TEXT("Error"), MB_OK); return nRet; } return SUCCESS; } static L_INT EXT_CALLBACK InetCallback(L_COMP hServer, L_INT nMessage, L_INT nError, L_CHAR * pBuffer, L_SIZE_T lSize, L_VOID * pUserData) { UNREFERENCED_PARAMETER(pBuffer); UNREFERENCED_PARAMETER(lSize); UNREFERENCED_PARAMETER(pUserData); L_INT nRet; L_COMP hClient; switch(nMessage) { case INET_CONNECT_REQUEST: /* check the status and send some data */ if(nError == SUCCESS) { /* somebody is trying to connect to our server accept the connection into the server created above */ nRet = L_InetAcceptConnect(hServer, &hClient, (INETCALLBACK) InetServerInitExample, NULL); if(nRet == SUCCESS) MessageBox(NULL, TEXT("Connection accepted successfully"), TEXT("Info"), MB_OK); /* remove the next line if you want to keep the connection open in your app you should save hClient in a list of active connections */ L_InetClose(hClient, TRUE); } else MessageBox(NULL, TEXT("You have failed to connect!"), TEXT("Error"), MB_OK); break; } return SUCCESS; }