L_InetSendFreeBitmapCmd

#include "l_bitmap.h"
#include "ltnet.h"

L_LTNET_API L_INT 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:	Sending Commands and Responses
	A Client-Server Diagram: Sending Commands and Responses

Example

You can use this function to instruct the remote computer to free a bitmap that you instructed him to load.

L_INT InetSendFreeBitmapCmdExample(L_COMP hComputer,
                                                  L_UINT uBitmapID,
                                                  L_UINT *guCommandID)
{
   return L_InetSendFreeBitmapCmd(hComputer, *guCommandID++, uBitmapID);
}