LInet::CommandCallBack

#include " ltwrappr.h "

virtual L_INT LInet::CommandCallBack(plConnection, uCommand, uCommandID, nError, uParams, pParams, uExtra, pExtra)

LInet * plConnection;	/* instance of a remote computer */
CMDTYPE uCommand;	/* command type */
L_UINT uCommandID;	/* command id */
L_INT nError;	/* status of the received data */
L_UINT uParams;	/* number of parameters */
pPARAMETER pParams;	/* pointer to an array of parameters */
L_UINT uExtra;	/* length */
L_CHAR * pExtra;	/* pointer to extra data */

Notifies a computer that a command has been received. This function is only available in the Internet toolkit.

Parameter	Description
plConnection	Instance of the remote computer from which the command was sent.
uCommand	Command received from the remote computer. For a list of possible values, refer to CMDTYPE.
uCommandID	Command Id. Each command sent by a member of a connection should have a unique ID. Since a member of a connection may send several messages, this ID allows that member to identify when a specific request has been completed.
nError	Determines whether the command was received properly. If not all the parameters were received properly, then nError will be set to an error code (usually ERROR_TRANSFER_ABORTED).
uParams	The number of parameters for this command.
pParams	Pointer to an array of PARAMETER structures that contain the parameters for the command.
uLength	Length of any extra data sent with the command.
pExtraInfo	Pointer to the extra data sent with the command.

Returns

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

Comments

A call to this overridable function is generated when a computer receives a command request from a remote computer.

To process commands, a class must be derived from LInet and this member function must be overridden.

When a command request is received, this function should respond by calling the corresponding response function. For example, if a SendLoadCmd request is received from a remote computer, this function should respond by calling LInet::SendLoadRsp.

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.

Functions:	LInet::ResponseCallBack, LInet::SendCmd, LInet::SendLoadCmd, LInet::SendCreateWinCmd, LInet::SendAttachBitmapCmd, LInet::SendSaveCmd, LInet::SendSizeWinCmd, LInet::SendShowWinCmd, LInet::SendCloseWinCmd, LInet::SendFreeBitmapCmd, LInet::SendSetRectCmd
Topics:	Sending Commands and Responses
	A Client Server Diagram: Sending Commands and Responses