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
Example
For an example, refer to LInet::SendCloseWinCmdExample.