LInet::OnUser2Received

#include "ltwrappr.h"

L_INT LInet::OnUser2Received(plConnection, nError, pBuffer, ulSize)

LInet L_FAR * plConnection;	/* instance of a remote computer */
L_INT nError;	/* error code */
L_CHAR L_FAR * pBuffer;	/* buffer containing data */
L_UINT32 ulSize;	/* size of the buffer */

Overridable function that notifies a computer that user defined data has been received.

Parameter	Description
plConnection	Pointer to the instance of the remote computer that sent the user-defined data.
nError	If no error has occurred, nError will be SUCCESS. If nError is < SUCCESS, an error has occurred.
pBuffer	Pointer to the buffer that contains the data of a user-defined format.
ulSize	Size of pBuffer.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

If nError is < SUCCESS, pBuffer should be ignored.

The buffer pointed to by pBuffer will be freed upon returning from this function.

Do not delete plConnection.

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:	Class Members
Topics:	Sending and Receiving Data

Example

// a user defined class derived from LInet should be used to support the
// OnUser2Received, OnUser3Received and OnUser4Received callback functions
// suppose it was named as LUserInet

LUserInet UserInet;
LInet L_FAR *plRemote;
L_CHAR L_FAR *pBuffer;
L_UINT32 L_FAR * pulBufferLength;

// connect to LEAD
UserInet.Connect("207.238.49.190", 1000);
UserInet.SendData(plRemote, pBuffer, pulBufferLength, IDATA_USER2);
UserInet.SendData(plRemote, pBuffer, pulBufferLength, IDATA_USER3);
UserInet.SendData(plRemote, pBuffer, pulBufferLength, IDATA_USER4);

L_INT LUserInet::OnUser2Received(LInet L_FAR plConnection, L_INT nError, L_CHAR L_FAR *pBuffer, L_UINT32 ulSize)
{
   // other operations
   return SUCCESS;
}

L_INT LUserInet::OnUser3Received(LInet L_FAR plConnection, L_INT nError, L_CHAR L_FAR
pBuffer, L_UINT32 ulSize)
{
   // other operations
   return SUCCESS;
}

L_INT LUserInet::OnUser4Received(LInet L_FAR plConnection, L_INT nError, L_CHAR L_FAR *pBuffer, L_UINT32 ulSize)
{
   // other operations
   return SUCCESS;
}