L_InetSendFreeBitmapCmd
#include "l_bitmap.h"
#include "ltnet.h"
L_INT EXT_FUNCTION L_InetSendFreeBitmapCmd(hComputer, uCommandID, uBitmapID)
L_COMP hComputer; |
/* handle to a remote computer */ |
L_UINT uCommandID; |
/* command id */ |
L_UINT uBitmapID; |
/* bitmap id */ |
Sends a free bitmap command to a remote computer.
Parameter |
Description |
hComputer |
Handle of the remote computer to which the command will be sent. |
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. |
uBitmapID |
The ID of the bitmap that should be freed. |
Returns
SUCCESS |
This function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
The remote computer should free the bitmap associated with uBitmapID and respond by calling L_InetSendFreeBitmapRsp in its INETCOMMANDCALLBACK function. This callback function must be set using L_InetSetCommandCallback.
The INETCOMMANDCALLBACK function will receive the uBitmapID information in the pParams parameter. The uBitmapID information will be in pParams[0].
To receive responses to commands, provide an INETRESPONSECALLBACK function. This function must be set using L_InetSetResponseCallback.
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: |
L_InetSendFreeBitmapRsp, INETRESPONSECALLBACK, INETCOMMANDCALLBACK |
Topics: |
|
|
Example
L_UINT guCommandID;
// you can use this function to instruct the remote computer to
// free a bitmap that you instructed him to load.
L_INT DeleteRemoteBitmap(L_COMP hComputer, L_UINT uBitmapID)
{
return L_InetSendFreeBitmapCmd(hComputer,
guCommandID++, uBitmapID);
}