L_InetSendShowWinCmd

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

L_INT EXT_FUNCTION L_InetSendShowWinCmd(hComputer, uCommandID, uWindowID, nCmdShow)

L_COMP hComputer;

/* handle to a remote computer */

L_UINT uCommandID;

/* command id */

L_UINT uWindowID;

/* window id */

L_INT nCmdShow;

/* show flag */

Sends a show 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 show.

nCmdShow

Specifies how the window is to be shown. The possible values are the same as the nCmdShow parameter of the ShowWindow command from the Windows SDK.

Returns

SUCCESS

This function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

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

The INETCOMMANDCALLBACK function will receive the uWindowID and the nCmdShow information in the pParams parameter. The uWindowID information will be in pParams[0] and the nCmdShow 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_InetSendShowWinRsp, 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 MaximizeRemoteWindow(L_COMP hComputer, L_UINT uWindowID)
{
   return L_InetSendShowWinCmd(hComputer, guCommandID++, uWindowID, SW_MAXIMIZE);
}