Método IWCContextMenuCallback::AddExtensionMenuItem (cluadmex.h)
[Este método está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. La compatibilidad con este método se quitó en Windows Server 2008.]
Agrega un elemento de menú a un menú contextual Administrador de clústeres de conmutación por error .
Sintaxis
HRESULT AddExtensionMenuItem(
[in] BSTR lpszName,
[in] BSTR lpszStatusBarText,
[in] ULONG nCommandID,
[in] ULONG nSubmenuCommandID,
[in] ULONG uFlags
);
Parámetros
[in] lpszName
Puntero a una cadena Unicode terminada en null que contiene el nombre del elemento que se va a agregar al menú. Aunque se declara como BSTR, este parámetro se implementa como LPWSTR.
[in] lpszStatusBarText
Puntero al texto que se va a mostrar en la barra de estado cuando se selecciona el nuevo elemento. Aunque se declara como BSTR, este parámetro se implementa como LPWSTR.
[in] nCommandID
Identificador del comando que se va a invocar cuando se selecciona el elemento de menú. El parámetro nCommandID no debe establecerse en –1.
[in] nSubmenuCommandID
Identificador de un submenú. No se admiten submenús y el parámetro nSubmenuCommandID debe ser cero.
[in] uFlags
Máscara de bits de marcas que describe el nuevo elemento de menú. Se pueden establecer uno o varios de los valores siguientes.
MF_CHECKED (8)
Actúa como un botón de alternancia con MF_UNCHECKED para colocar la marca de verificación predeterminada junto al elemento.
MF_UNCHECKED (0)
Actúa como un botón de alternancia con MF_CHECKED para quitar una marca de verificación situada junto al elemento.
MF_DISABLED (2)
Deshabilita el elemento de menú para que no se pueda seleccionar, pero no se atenúa.
MF_ENABLED (0)
Habilita el elemento de menú para que se pueda seleccionar y restaurarlo a partir de su estado atenuado si el elemento se atenúa anteriormente.
MF_GRAYED (1)
Deshabilita el elemento de menú para que no se pueda seleccionar y atenuarlo.
MF_MENUBARBREAK (32 (0x20))
Places el elemento de una nueva columna. La nueva columna se separa de la columna anterior mediante una línea divisoria vertical.
MF_MENUBREAK (64 (0x40))
Places el elemento de una nueva columna. No se coloca ninguna línea divisoria entre las columnas.
MF_SEPARATOR (2048 (0x800))
Dibuja una línea divisoria horizontal. Esta línea no se puede atenuar, deshabilitar ni resaltar. Se omiten los parámetros lpszName y lpszStatusBarText .
MF_STRING (0)
Especifica que el elemento de menú es una cadena de caracteres. El parámetro lpszName contiene un puntero a una cadena Unicode terminada en NULL. Esta es la interpretación predeterminada.
Valor devuelto
Si AddExtensionMenuItem no se realiza correctamente, puede devolver otros valores HRESULT .
| Código o valor devuelto | Descripción |
|---|---|
|
La operación se realizó correctamente. |
|
El parámetro uFlags se estableció en MF_OWNERDRAW o MF_POPUP. |
|
Error al asignar el elemento de menú. |
Comentarios
El método AddExtensionMenuItem agrega elementos en la parte superior del menú contextual y los sigue un separador. El comando identificado por nCommandID se pasa en el parámetro nCommandID al método IWEInvokeCommand::InvokeCommand cuando el usuario selecciona este elemento de menú.
Tenga en cuenta que las marcas MF_OWNERDRAW y MF_POPUP no se admiten específicamente para el parámetro uFlags .
Las extensiones de administrador de clústeres de conmutación por error llaman a AddExtensionMenuItem desde su método IWEExtendContextMenu::AddContextMenuItems.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2003 Enterprise, Windows Server 2003 Datacenter |
| Plataforma de destino | Windows |
| Encabezado | cluadmex.h |