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.

See Also

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

Example

For an example, refer to LInet::SendCloseWinCmdExample.