LInet::SendShowWinCmd

#include " ltwrappr.h "

L_INT LInet::SendShowWinCmd (plRemoteComp, uCommandID, uWindowID, nCmdShow)

Sends a show window command to a remote computer. This function is only available in the Internet toolkit.

Returns

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

See Also

Example

//This example sends a message to a remote connection to maximize 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.  GetNextCommandID() is a function that returns a unique command identifier
//5.  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()
void CMainFrame::OnRemoteSendshowwincmd () 
{
   L_INT nRet = SUCCESS;
   
   nRet = m_Inet.SendShowWinCmd(
      m_pInetRemoteServer,
      GetNextCommandID(),
      m_uWindowID, 
      SW_SHOWMAXIMIZED
      );
   
   if(nRet != SUCCESS && nRet != ERROR_DATA_QUEUED)
      UpdateStatusbar(TEXT("Error[%d] OnRemoteSendshowwincmd"), nRet);
}

//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 CMyNet::CommandCallBack (LInet L_FAR * plConnection,
                              CMDTYPE     uCommand,
                              L_UINT      uCommandID,
                              L_INT       nError,
                              L_UINT      uParams, 
                              pPARAMETER  pParams, 
                              L_UINT      uExtra,
                              L_CHAR L_FAR*pExtra)
{
   L_INT nStatus = ERROR_FEATURE_NOT_SUPPORTED;
   L_UINT          uBitmapID = (L_UINT)-1;
      
   CMainFrame *pMain;
   pMain = GETMAINFRAME;
   
   if(nError != SUCCESS)
      nStatus = ERROR_TRANSFER_ABORTED;
   else
      switch(uCommand)
      {
      case CMD_SHOW_WIN:
         {
            L_INT  nStatus = SUCCESS;
            L_INT  nRet;
            HWND   uWindowID = (HWND)pParams[0].uiValue;
            L_INT  nCmdShow  = pParams[1].iValue;
            
            if (IsWndValid((HWND)uWindowID))
            {
               nRet = ::ShowWindow(
                  ::GetParent((HWND)uWindowID), 
                  nCmdShow
                  );
               if (nRet == 0)
                  nStatus = FAILURE;
            }
            else
            {
               nStatus = ERROR_INV_PARAMETER;
            }
            return pMain->m_Inet.SendShowWinRsp (plConnection, uCommandID, 0, NULL, nStatus);
         }
         break;   
      default: 
         {
            return nStatus; 
         }
      }
   return nStatus; 
}