LInet::SendSaveCmd

#include " ltwrappr.h "

L_INT LInet::SendSaveCmd (plRemoteComp, uCommandID, pszFile, uBitmapID, nFormat, nBitsPerPixel, nQFactor, uFlags)

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

Returns

Comments

The remote computer should respond by calling LInet::SendLoadRspin its LInet::CommandCallBackfunction.

With this command, the local computer will signal the remote computer to save a bitmap.

To process responses to commands, a class must be derived from LInet and the LInet::ResponseCallBackmember function must be overridden.

The LInet::CommandCallBackfunction will receive the pszFile, uBitmapID, nFormat, nBitsPerPixel, nQFactor and uFlags information in the pParams parameter. The pszFile information will be in pParams[0]. The uBitmapID information will be in pParams[1], the nFormat information will be in pParams[2], and so forth.

Required DLLs and Libraries

See Also

Example

//This example sends a message to a remote connection save a loaded bitmap locally
//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_uBitmapID is a bitmap id that is received in the LInet::ResponseCallBack() as a result
//    of a call to m_Inet.SendLoadCmd()
void CMainFrame::OnRemoteSavebitmap () 
{
   L_INT nRet;
   nRet = m_Inet.SendSaveCmd(
      m_pInetRemoteServer, 
      GetNextCommandID(), 
      TEXT("c:\\temp\\remote.tif"), 
      m_uBitmapID, 
      FILE_TIF);
   
   if(nRet != SUCCESS && nRet != ERROR_DATA_QUEUED)
      UpdateStatusbar(TEXT("Error[%d]: OnRemoteSavebitmap"), 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_SAVE: 
      {
            uBitmapID = pParams[1].uiValue; 
            
            //Here you would look up the uBitmapID in a list 
            //of BitmapWindow objects maintained on the server.  
            //If the ID is valid, save as a local file on the 
            //server (pParams[0]) 
            
            //Something like this... 
            /*
            LBitmapWindow *pBitmapWindow = m_BitmapList[uBitmapID]; 
            
            //pParams[0] file name
            //pParams[1] bitmap id
            //pParams[2] nFormat
            //pParams[3] nBitsPerPixel
            //pparams[4] nQFactor
            //pParams[5] uFlags
              
            if (pBitmapWindow != NULL) 
            {   
                   L_INT nRet; 
                   nRet = pBitmapWindow->Save(
                   pParams[0].pValue, 
                   pParams[2].iValue, 
                   pParams[3].iValue, 
                   pParams[4].iValue, 
                   pParams[5].iValue
                   ); 
                  if (nRet != SUCCESS) 
                       nStatus = FAILURE; 
            }
            */
         }
         return pMain->m_Inet.SendSaveRsp(
                   plConnection, 
                   uCommandID, 
                   0, 
                  NULL, 
                  nStatus); 
         break; 
         
      default: 
         {
            return nStatus; 
         }
   }
   return nStatus; 
}