L_InetSendCmd
#include "l_bitmap.h"
#include "ltnet.h"
L_INT EXT_FUNCTION L_InetSendCmd(hComputer, uCommand, uCommandID, hPacket)
L_COMP hComputer; |
/* handle to a remote computer */ |
CMDTYPE uCommand; |
/* command type */ |
L_UINT uCommandID; |
/* command id */ |
HINETPACK hPacket; |
/* handle to the packet object */ |
Sends a command to a remote computer.
Parameter |
Description |
hComputer |
Handle to the remote computer to which the command will be sent. |
uCommand |
The command to send. 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 commands, this ID allows that member to identify when a specific command request has been completed. |
hPacket |
Handle to an INET packet object containing the parameters for the command. You can pass NULL if the command doesn�t need any parameters. |
Returns
SUCCESS |
This function was successful. |
< 1 |
An occurred. Refer to Return Codes. |
Comments
The remote computer should respond by calling L_InetSendRsp in its INETCOMMANDCALLBACK function. This callback function must be set using L_InetSetCommandCallback.
To receive responses to commands, provide an INETRESPONSECALLBACK function. This function must be set using L_InetSetResponseCallback.
Some commands will send back only the command�s status (indicating whether the command succeeded or not). But some commands will send back additional information if the command succeeds. For example, responses to L_InetSendLoadCmd will send the bitmap ID while responses to L_InetSendCreateWinCmd will send the window identifier (which can be used to resize or close the window).
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
Funtions: |
L_InetSendRsp, INETCOMMANDCALLBACK, INETRESPONSECALLBACK, L_InetSetCommandCallback |
Topics: |
|
|
Example
For an example, refer to L_InetCreatePacket.