L_InetSendCloseWinCmd

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

L_INT EXT_FUNCTION L_InetSendCloseWinCmd(hComputer, uCommandID, uWindowID)

L_COMP hComputer;

/* handle to a remote computer */

L_UINT uCommandID;

/* command id */

L_UINT uWindowID;

/* window id */

Sends a close window 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.

uWindowID

The id of the window to close.

Returns

SUCCESS

This function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

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

The INETCOMMANDCALLBACK function will receive the uWindowID information in the pParams parameter. The uWindowID 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_InetSendCloseWinRsp, INETRESPONSECALLBACK, INETCOMMANDCALLBACK

Topics:

Sending Commands and Responses

 

A Client-Server Diagram: Sending Commands and Responses

Example

L_UINT guCommandID;

// Note that pszRemoteFilename is a file name on the remote computer!
L_INT CloseRemoteWindow(L_COMP hComputer, L_UINT uWindowID)
{
   return L_InetSendCloseWinCmd(hComputer, guCommandID++, uWindowID);
}