LInet::OnDataReceiving

#include "ltwrappr.h"

virtual L_INT LInet::OnDataReceiving(plConnection, nError, pBuffer, ulSize)

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

Overridable function that notifies a computer that data is being received from a remote connection.

Parameter	Description
plConnection	Pointer to the instance of the remote computer that is sending the 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.
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 
// OnDataReceiving callback functions
// suppose it was named as LUserInetODR
class LUserInetODR : public LInet
{
protected:
   virtual  L_INT OnDataReceiving(LInet plConnection, L_INT nError, L_CHAR pBuffer, L_UINT32 ulSize);
};
L_INT LInet__OnDataReceivingExample()
{
   L_INT          nRet;
   LUserInetODR   UserInet;
   // connect to LEAD
   nRet = UserInet.Connect("207.238.49.190", 1000);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}
L_INT LUserInetODR::OnDataReceiving(LInet plConnection, L_INT nError, L_CHAR pBuffer, L_UINT32 ulSize)
{
   UNREFERENCED_PARAMETER(nError);
   UNREFERENCED_PARAMETER(pBuffer);
   UNREFERENCED_PARAMETER(ulSize);
   // other operations
     return SUCCESS;
}