LInet::SendLoadCmd

#include " ltwrappr.h "

L_INT LInet::SendLoadCmd (plRemoteComp, uCommandID, pszFile, nBitsPerPixel=0, nOrder=ORDER_BGR, uFlags=LOADFILE_ALLOCATE|LOADFILE_STORE)

Sends a load 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 load a bitmap and send across the bitmap identifier (not the bitmap data!). The local computer can then use the bitmap identifier in other commands (like LInet::SendAttachBitmapCmd). The bitmap identifier will be sent in the response to this command.

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

The LInet::CommandCallBack function will receive the pszFile, nBitsPerPixel, nOrder and uFlags information in the pParams parameter. The pszFile information will be in pParams[0]. The nBitsPerPixel information will be in pParams[1], and so forth.

Required DLLs and Libraries

See Also

Example

//This example sends a message to a remote connection to load a bitmap
//It 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
void CMainFrame::OnRemoteLoadbitmap () 
{
   L_INT nRet = SUCCESS;
   
   nRet = m_Inet.SendLoadCmd(m_pInetRemoteServer, GetNextCommandID(), TEXT("..\\images\\image2.cmp"));
   if(nRet != SUCCESS && nRet != ERROR_DATA_QUEUED)
   {
      UpdateStatusbar(TEXT("Error[%d]: OnRemoteLoadbitmap"), nRet);
   }
   else
   {
      UpdateStatusbar(TEXT("Success: OnRemoteLoadbitmap"), 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)
{
  CMainFrame *pMain; 
  pMain = GETMAINFRAME; 

   L_INT nStatus = ERROR_FEATURE_NOT_SUPPORTED; 
   L_UINT          uBitmapID = (L_UINT)-1; 
      
   if(nError != SUCCESS) 
      nStatus = ERROR_TRANSFER_ABORTED; 
   else
      switch(uCommand) 
   {
      case CMD_LOAD: 
      {  
            //Here you would add the name bitmap to a list of bitmaps 
            //maintained on the server
            //You must return an ID of the bitmap to the client
            L_INT nIndex=0; 
            
            /* Code example
            nIndex = m_BitmapList.AddBitmap(
               pParams[0].pValue, //file name
               pParams[1].iValue, //nBitsPerPixel
               pParams[2].iValue  //nOrder
               ); 
               */
                        
            return m_Inet.SendLoadRsp(
                                              plConnection, 
                                              uCommandID, 
                                              uBitmapID, 
                                              0, 
                                              NULL, 
                                              nStatus); 
      }
      break;  
      default: 
      {
         return nStatus; 
      }
   }
   return nStatus; 
}