Método IWEExtendContextMenu::AddContextMenuItems (cluadmex.h)

Artículo
03/08/2023

[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.]

Permite crear elementos de menú contextual para un objeto de clúster y agregar los elementos a un menú contextual Administrador de clústeres de conmutación por error.

Sintaxis

HRESULT AddContextMenuItems(
  [in] IUnknown               *piData,
  [in] IWCContextMenuCallback *piCallback
);

Parámetros

[in] piData

Puntero de interfaz IUnknown para recuperar información relacionada con el nuevo elemento de menú. Al llamar al método IUnknown::QueryInterface con el puntero piData , están disponibles las siguientes interfaces:

Dependiendo del tipo de objeto de clúster para el que se crea el menú contextual, también puede estar disponible una de las siguientes interfaces:

IGetClusterNodeInfo, si el elemento de menú está relacionado con un nodo.
IGetClusterGroupInfo, si el elemento de menú está relacionado con un grupo.
IGetClusterNetworkInfo, si el elemento de menú está relacionado con una red.
IGetClusterNetInterfaceInfo, si el elemento de menú está relacionado con una interfaz de red.
IGetClusterResourceInfo, si el elemento de menú está relacionado con un recurso.

[in] piCallback

Puntero a una implementación de la interfaz IWCContextMenuCallback para agregar nuevos elementos al menú contextual Administrador de clústeres.

Valor devuelto

Devuelve uno de los siguientes valores o cualquier HRESULT que describa los resultados de la operación.

Código o valor devuelto	Descripción
NOERROR 0	La operación se realizó correctamente.
E_INVALIDARG 0x80070057	Al menos uno de los parámetros no es válido.
E_NOTIMPL 0x80004001	La extensión no admite la adición de elementos de menú contextual.

Comentarios

Para implementar AddContextMenuItems

Llame al método IUnknown::QueryInterface al que apunta piData para recuperar un puntero a una interfaz que pueda proporcionar información sobre el objeto asociado al elemento de menú.
Llame al método IWCContextMenuCallback::AddExtensionMenuItem mediante el puntero piCallback para agregar el elemento al menú.

Para agregar elementos de menú contextual e implementar código que se ejecuta cuando se seleccionan los elementos del menú contextual, implemente el método IWEInvokeCommand::InvokeCommand .

Requisitos


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