LInet::SendCloseWinCmd
#include " ltwrappr.h "
L_INT LInet::SendCloseWinCmd (plRemoteComp, uCommandID, uWindowID)
|
LInet * plRemoteComp; |
/* instance of a remote computer */ |
|
L_UINT uCommandID; |
/* command id */ |
|
LONG_PTR uWindowID; |
/* window id */ |
Sends a close 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 close. |
Returns
|
SUCCESS |
This function was successful. |
|
< 1 |
An error occurred. Refer to Return Codes. |
Comments
The remote computer should respond by calling LInet::SendCloseWinRsp in its LInet::CommandCallBack function.
The LInet::CommandCallBackfunction will receive the uWindowID information in the pParams parameter. The uWindowID information will be in pParams[0].
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::SendCloseWinRsp, LInet::ResponseCallBack, LInet::CommandCallBack, Class Members |
|
Topics: |
|
|
|
Example
//This example sends a message to a remote connection to close a window
//It is assumed that:
//1. m_Inet and m_pInetRemoteServer are an object of the class LInet.
//2. the network as been started (LInet::StartUp())
//3. a connection has been established with a remote server (LInet::m_Inet.Connect())
//4. UpdateStatusbar() is a function that displays a message in the status bar
//6. m_uWindowID is a window id that is received in the LInet::ResponseCallBack() as a result
// of a call to m_Inet.SendCreateWinCmd()
enum
{
CMD_FLIP = CMD_USER_CUSTOM,
CMD_GET,
CMD_REVERSE,
CMD_90,
CMD_180,
CMD_SHEAR,
CMD_RESIZE,
CMD_POSTERIZE,
CMD_NOISE,
CMD_OILIFY,
CMD_RESOLUTION,
CMD_INVERT,
CMD_CONTRAST,
CMD_SATURATION,
CMD_GAMMA,
CMD_LOADPATH
};
class LUserNet : 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);
};
LUserNet m_ClientInet;
L_INT LInet__SendCloseWinCmdExample(LInet *pInetRemoteServer, L_UINT uWindowID)
{
m_ClientInet.SendCloseWinCmd(
pInetRemoteServer,
1000,
uWindowID
);
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
//
//Assume that
//1. m_Inet is an object of the class CMyNet (derived from LInet).
//2. the network as been started (LInet::StartUp())
//3. a connection has been established with a remote client
//4. UpdateStatusbar() displays a message in the status bar
//5. m_BitmapList maintains a list of LBitmapWindow objects
L_INT LUserNet::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_CLOSE_WIN:
{
//Add your code here
}
break;
default:
{
return nStatus;
}
}
return nStatus;
}