Share via


CMINVOKECOMMANDINFO

4/8/2010

The Windows Mobile CMINVOKECOMMANDINFO structure invokes the context menu command.

Syntax

struct _CMInvokeCommandInfo {
  DWORD cbSize;
  DWORD fMask;
  HWND hwnd;
  LPCSTR lpVerb;
  LPCSTR lpParameters;
  LPCSTR lpDirectory;
  int nShow;
  DWORD dwHotKey;
   HANDLE hIcon;
} CMINVOKECOMMANDINFO,  *LPCMINVOKECOMMANDINFO;

Members

  • cbSize
    The size of the CMINVOKECOMMANDINFO structure, in bytes.
  • fMask
    Enables the dwHotkey, hIcon, and hwnd parameters. This flag can be zero, or any combination of CMIC_MASK_* flags. For a list of the possible CMIC_MASK_* flags, see the table below.
  • hwnd
    Handle of the window to which the shortcut menu belongs. An extension can also use this handle as the owner of any message boxes or dialog boxes it displays. Set hwnd to NULL if you want to indicate that there is no owner window.
  • lpVerb
    A 32-bit value containing the command being invoked, expressed as either a string (for programmatic invocation), or a menu-identifier offset (for user invocation).

    When containing a string, the HIWORD is non-zero. In this case, lpVerb contains the address of a null-terminated string specifying the language-independent name of the command. The system provides predefined constant values for some command strings. For details, see the table below.

    When containing a menu-identifier offset, the HIWORD is zero. In this case, lpVerb contains a menu-identifier offset of the command in the LOWORD. The shell specifies this value using MAKEINTRESOURCE(idOffset). For details, see "User Interface Services" in the Windows CE .NET 4.2 documentation.

  • lpParameters
    [Optional] Any parameters associated with the command. Set lpParameters to NULL if you want to indicate that the command takes no parameters.
  • lpDirectory
    [Optional] The working directory. Set lpDirectory to NULL if you want to indicate that there is no working directory.
  • nShow
    Sets the window's show state. The show state is specified in the flag passed to the function ShowWindow. For more information about ShowWindow, see "User Interface Services" in the Windows CE .NET 4.2 documentation.
  • dwHotKey
    [Optional] Hotkey to associate with the command.
  • hIcon
    Not used.

The following table lists the possible CMIC_MASK_* flags.

Flag Description

CMIC_MASK_HOTKEY

The dwHotKey member is valid, so use an optional hotkey.

CMIC_MASK_FLAG_NO_UI

The system is prevented from displaying user interface elements while carrying out the command. An example is error messages.

The following table lists the predefined constant values that the system provides for the lpVerb command string.

Flag Description

CMDSTR_NEWFOLDER

NewFolder

CMDSTR_VIEWLIST

ViewList

CMDSTR_VIEWDETAILS

ViewDetails

Requirements

Header shlobj.h
Windows Embedded CE Windows CE .NET 4.2 and later
Windows Mobile Pocket PC for Windows Mobile 2003 and later

See Also

Reference

Shell Structures
IContextMenu::InvokeCommand