L_InetSendAttachBitmapCmd

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

L_LTNET_API L_INT L_InetSendAttachBitmapCmd(hComputer, uCommandID, uBitmapID, uWindowID)

L_COMP hComputer;	/* handle to a remote computer */
L_UINT uCommandID;	/* command id */
L_UINT uBitmapID;	/* bitmap id */
LONG_PTR uWindowID;	/* window id */

Sends an attach 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 being attached. If the bitmap is successfully attached, then this bitmap will be painted whenever the window paints itself.
uWindowID	The id of the window that was just created.

Returns

SUCCESS	This function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

The remote computer should respond by calling L_InetSendAttachBitmapRsp in its INETCOMMANDCALLBACK function. This callback function must be set using L_InetSetCommandCallback.

Once the remote computer receives this command it should always paint the specified bitmap inside the specified window. Both the bitmap and the window should exist on the remote computer. The remote computer will most likely paint the window at 1:1 ratio, adding scrollbars if possible. To change the way the bitmap is painted, call L_InetSendSetRectCmd.

The INETCOMMANDCALLBACK function will receive the uBitmapID and uWindowID information in the pParams parameter. The uBitmapID information will be in pParams[0] and the uWindowID information will be in pParams[1].

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_InetSendAttachBitmapRsp, INETRESPONSECALLBACK, INETCOMMANDCALLBACK
Topics:	Sending Commands and Responses
	A Client-Server Diagram: Sending Commands and Responses

Example

L_INT InetSendAttachBitmapCmdExample(L_COMP hComputer,
                                                    L_UINT uBitmapID,
                                                    L_UINT uWindowID,
                                                    L_UINT *guCommandID)
{
   return L_InetSendAttachBitmapCmd(hComputer, *guCommandID++, uBitmapID, uWindowID);
}