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:

Sending Commands and Responses

 

A Client-Server Diagram: Sending Commands and Responses

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);
}