LInet::OnDataStart

#include "ltwrappr.h"

virtual L_INT LInet::OnDataStart(plConnection, nError)

LInet * plConnection;

/* instance of a remote computer */

L_INT nError;

/* error code */

Overridable function that notifies the computer that it has started to receive data.

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.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

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 OnDataStart callback function
// suppose it was named as LUserInetODStart
class LUserInetODStart : public LInet
{
protected:
   virtual L_INT OnDataStart(LInet plConnection, L_INT nError);
};
L_INT LInet__OnDataStartExample()
{
   L_INT             nRet;
   LUserInetODStart  UserInet;
   // connect to LEAD
   nRet = UserInet.Connect("207.238.49.190", 1000);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}
L_INT LUserInetODStart::OnDataStart(LInet plConnection, L_INT nError)
{
   UNREFERENCED_PARAMETER(nError);
   // other operations
     return SUCCESS;
}