L_InetServerInit

#include "l_bitmap.h"
#include "ltnet.h"

L_INT EXT_FUNCTION L_InetServerInit(nPort, phComputer, pfnCallback, pUserData)

L_INT nPort;	/* port on which to listen */
L_COMP L_FAR * phComputer;	/* address of variable to update */
INETCALLBACK pfnCallback;	/* pointer to a callback function */
L_VOID L_FAR *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	Mail
	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 L_FAR *. 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:	Internet Functions

Example

L_COMP hServer; /* the handle to the server */
L_INT nRet;

L_INT L_EXPORT EXT_CALLBACK InetCallback(L_COMP hComp,
L_INT nMessage, L_INT nError, L_CHAR L_FAR *pBuffer,
L_UINT32 lSize,L_VOID L_FAR*pUserData);

/* you do not need to use MakeProcInstance for 32 bit applications */
nRet = L_InetServerInit(1000, &hServer, InetCallback, NULL);
if(nRet != SUCCESS)
MessageBox(NULL, TEXT("The server failed to start!"), TEXT("Error"), MB_OK);

L_INT L_EXPORT EXT_CALLBACK InetCallback(L_COMP hComp,
L_INT nMessage, L_INT nError, L_CHAR L_FAR *pBuffer,
L_UINT32 lSize,L_VOID L_FAR*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, 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;
}