LInet::SendShowWinCmd
#include " ltwrappr.h "
L_INT LInet::SendShowWinCmd (plRemoteComp, uCommandID, uWindowID, nCmdShow)
LInet * plRemoteComp; |
/* instance of a remote computer */ |
L_UINT uCommandID; |
/* command id */ |
LONG_PTR uWindowID; |
/* window id */ |
L_INT nCmdShow; |
/* show flag */ |
Sends a show window command to a remote computer. This function is only available in the Internet toolkit.
Parameter |
Description |
plRemoteComp |
Instance 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 LInet::SendShowWinRsp in its LInet::CommandCallBack function.
The LInet::CommandCallBackfunction 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 process responses to commands, a class must be derived from LInet and the LInet::ResponseCallBackmember function must be overridden.
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: |
LInet::SendShowWinRsp, LInet::ResponseCallBack, LInet::CommandCallBack, Class Members |
Topics: |
|
|
Example
//This example sends a message to a remote connection to create a window. //It is assumed that: //1. the network as been started (LInet::StartUp()) //2. a connection has been established with a remote server (LInet::m_Inet.Connect()) class LUserNet7 : public LInet { public: L_INT OnConnect(LInet *plConnection, L_INT nError) { L_INT nRet = SUCCESS; L_CHAR *pszHostName; L_TCHAR strMsg[L_MAXPATH]; if(nError != SUCCESS) { wsprintf(strMsg, _T("Error[%d]: OnConnect"), nRet); MessageBox(NULL, strMsg, 0 , 0); return nError; } // Get the remote computer name if ((pszHostName = plConnection->GetHostName(HOST_NAME_IP)) == NULL) return FAILURE; wsprintf(strMsg, _T("OnConnect: Connected to %hs"), (LPTSTR)pszHostName); MessageBox(0, strMsg, 0, 0); this->SendLoadCmd(plConnection, CMD_LOAD, TEXT("E:\\Program Files\\LEAD Technologies\\LEADTOOLS 15\\Images\\IMAGE1.CMP")); return nRet; } L_INT CommandCallBack (LInet * plConnection, CMDTYPE uCommand, L_UINT uCommandID, L_INT nError, L_UINT uParams, pPARAMETER pParams, L_UINT uExtra, L_CHAR*pExtra); }; LUserNet7 m_ClientInet; L_INT LInet__SendShowWinCmdExample(LInet * pInetRemoteServer, L_UINT uWindowID) { L_INT nRet = SUCCESS; nRet = m_ClientInet.SendShowWinCmd( pInetRemoteServer, 0, uWindowID, SW_SHOWMAXIMIZED); if(nRet != SUCCESS && nRet != ERROR_DATA_QUEUED) return nRet; return SUCCESS; } //The CommandCallBack() is processed on the server //To process the commands sent to the computer, you must: //1. Derive a class from LInet //2. Override the CommandCallBack member function L_INT LUserNet7::CommandCallBack (LInet * plConnection, CMDTYPE uCommand, L_UINT uCommandID, L_INT nError, L_UINT uParams, pPARAMETER pParams, L_UINT uExtra, L_CHAR*pExtra) { UNREFERENCED_PARAMETER(pExtra); UNREFERENCED_PARAMETER(uExtra); UNREFERENCED_PARAMETER(uParams); UNREFERENCED_PARAMETER(pParams); UNREFERENCED_PARAMETER(uCommandID); UNREFERENCED_PARAMETER(plConnection); L_INT nStatus = ERROR_FEATURE_NOT_SUPPORTED; if(nError != SUCCESS) nStatus = ERROR_TRANSFER_ABORTED; else { switch(uCommand) { case CMD_SHOW_WIN: { L_INT nStatus = SUCCESS; L_INT nRet; HWND uWindowID = (HWND)(INT_PTR)(pParams[0].uiValue); L_INT nCmdShow = pParams[1].iValue; if (IsWindow((HWND)(INT_PTR)uWindowID)) { nRet = ::ShowWindow(::GetParent((HWND)uWindowID), nCmdShow); if (nRet == 0) nStatus = FAILURE; } } break; default: { return nStatus; } } } return nStatus; }