L_InetSendCreateWinCmd

#include "l_bitmap.h"
#include "ltnet.h"

L_INT EXT_FUNCTION L_InetSendCreateWinCmd(hComputer, uCommandID, pszClassName, pszWindowName, ulFlags, nLeft, nTop, nWidth, nHeight, uParentID)

L_COMP hComputer;	/* handle to a remote computer */
L_UINT uCommandID;	/* command id */
L_TCHAR L_FAR * pszClassName;	/* window class name */
L_TCHAR L_FAR * pszWindowName;	/* name of window */
L_UINT ulFlags;	/* window creation flags */
L_INT nLeft;	/* x coordinate */
L_INT nTop;	/* y coordinate */
L_INT nWidth;	/* width */
L_INT nHeight;	/* height */
L_UINT uParentID;	/* parent id */

Sends a create win command to a remote computer.

Parameter	Description
hComputer	Handle 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.
pszClassName	Character string containing the class name for which to register the window. This must be a valid string, and should be related to your application, to avoid conflicting with an existing registered window class name.
pszWindowName	Character string containing the name of the window. This parameter can be an empty string ("").
ulFlags	Flags that indicate how to create the window. It is recommended to use the same flags shown in CreateWindow in the Microsoft SDK. However, you can pass 0 if you do not wish to use ulFlags, or you can define your own flags
nLeft	X coordinate for the origin of the window to create.
nTop	Y coordinate for the origin of the window to create.
nWidth	Requested width of the window's client area.
nHeight	Requested height of the window's client area.
uParentID	Id of the parent or owner window of the window being created.

Returns

SUCCESS	This function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

The remote computer should respond by calling L_InetSendCreateWinRsp in its INETCOMMANDCALLBACK function. This callback function must be set using L_InetSetCommandCallback.

With this command, the local computer will signal the remote computer to create a window using the specified parameters. The window identifier will be sent in the response to this command.

To receive responses to commands, provide an INETRESPONSECALLBACK function. This function must be set using L_InetSetResponseCallback.

The INETCOMMANDCALLBACK function will receive the pszClassName, pszWindowName, ulFlags, nLeft, nTop, nWidth, nHeight and uParentID information in the pParams parameter. The pszClassName information will be in pParams[0]. The pszWindowName information will be in pParams[1], the ulFlags information will be in pParams[2], and so forth.

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:	L_InetSendCreateWinRsp, INETRESPONSECALLBACK, INETCOMMANDCALLBACK
Topics:	Sending Commands and Responses
	A Client-Server Diagram: Sending Commands and Responses

Example

L_UINT guCommandID;

//********** Code on the local computer ****************/
// Note that pszRemoteFilename is a file name on the remote computer!
L_INT CreateRemoteWindow(L_COMP hComputer)
{
return L_InetSendCreateWinCmd(hComputer, guCommandID++, TEXT(""), // class
TEXT("Window created by remote computer"), // title
0, // flags
100, 50, 300, 150, // position and size
0); // parent
}

//********** Code on the remote computer ****************/
HWND CreateChildWindow(L_TCHAR L_FAR *pszClassName, L_TCHAR L_FAR *pszWindowName, L_UINT32 ulFlags, L_INT nLeft, L_INT nTop, L_INT nWidth, L_INT nHeight, L_UINT hwndParent)
{
// create the window here…

   return 0;
}

L_INT AttachBitmap(L_UINT uBitmapID, L_UINT uWindowID)
{
   // Attach the local bitmap uBitmapID to the local window uWindowID
   // To put it another way, "Make the bitmap with ID bitmap ID paint in the window uWindowID"
   // Usually, the window ID is the window handle.
   // For a complete example, see the NETCMD sample application.
   return 0;

}

L_INT EXT_CALLBACK InetCommandCallback(L_COMP hComputer, CMDTYPE uCommand, L_UINT uCommandID, L_INT nError, L_UINT uParams,
pPARAMETER pParams, L_UINT uExtra, L_CHAR L_FAR *pExtra, L_VOID L_FAR *pUserData)
{
   L_INT nStatus = ERROR_INV_PARAMETER;
   L_UINT uBitmapID = (L_UINT)-1;
   if(nError != SUCCESS)
      nStatus = ERROR_TRANSFER_ABORTED;
   else
      switch(uCommand)
      {
         case CMD_CREATE_WIN:
            // check the validity of the parameters
            if(uParams == 8 && pParams[0].uType == PARAM_STRING && pParams[1].uType == PARAM_STRING && pParams[2].uType == PARAM_UINT32 && pParams[3].uType == PARAM_INT32 && pParams[4].uType == PARAM_INT32 && pParams[5].uType == PARAM_INT32 && pParams[6].uType == PARAM_INT32 && pParams[7].uType == PARAM_UINT32)
            {
               HWND hwnd = CreateChildWindow((L_TCHAR*)pParams[0].pValue, (L_TCHAR*)pParams[1].pValue,
               pParams[2].uiValue, pParams[3].iValue, pParams[4].iValue,
               pParams[5].iValue, pParams[6].iValue,
               pParams[7].uiValue);

               // If CreateChildWindow failed, one of the parameters must be invalid
               nStatus = hwnd ? SUCCESS : ERROR_INV_PARAMETER;
               return L_InetSendCreateWinRsp(hComputer, uCommandID,
               (L_UINT)hwnd, 0, NULL, nStatus);
            }
         break;
         case CMD_ATTACH_BITMAP:
            if(uParams == 2 && pParams[0].uType == PARAM_UINT32 && pParams[1].uType == PARAM_UINT32)
               nStatus = AttachBitmap(pParams[0].uiValue, pParams[1].uiValue);
               return L_InetSendAttachBitmapRsp(hComputer, uCommandID, 0, NULL, nStatus);
         case CMD_SIZE_WIN:
            if(uParams == 5 && pParams[0].uType == PARAM_UINT32 && pParams[1].uType == PARAM_INT32 && pParams[2].uType == PARAM_INT32 && pParams[3].uType == PARAM_INT32 && pParams[4].uType == PARAM_INT32)
            {
               // move and repaint the window
               if(MoveWindow((HWND) pParams[0].uiValue,
                  pParams[1].iValue, pParams[2].iValue,
                  pParams[3].iValue, pParams[4].iValue, TRUE))
                  nStatus = SUCCESS;
            }
            return L_InetSendSizeWinRsp(hComputer, uCommandID, 0, NULL, nStatus);
         case CMD_SHOW_WIN:
            if(uParams == 2 && pParams[0].uType == PARAM_UINT32 && pParams[1].uType == PARAM_INT32)

            {
            if(IsWindow((HWND)pParams[0].uiValue))
            {
               ShowWindow((HWND)pParams[0].uiValue, pParams[1].iValue);
               nStatus = SUCCESS;
            }
         }
         return L_InetSendShowWinRsp(hComputer, uCommandID, 0, NULL, nStatus);
         case CMD_CLOSE_WIN:
            if(uParams == 1 && pParams[0].uType == PARAM_UINT32)
            {
               if(DestroyWindow((HWND)pParams[0].uiValue))
                  nStatus = SUCCESS;
            }
            return L_InetSendCloseWinRsp(hComputer, uCommandID, 0, NULL, nStatus);
         default:
            // this command is not supported
            nStatus = ERROR_FEATURE_NOT_SUPPORTED;
         break;
      }
   return L_InetSendRsp(hComputer, uCommand, uCommandID, NULL, nStatus);
}