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

Article
08/22/2023

[Cette méthode est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. La prise en charge de cette méthode a été supprimée dans Windows Server 2008.]

Vous permet de créer des éléments de menu contextuel pour un objet de cluster et d’ajouter les éléments à un menu contextuel Administrateur de cluster de basculement .

Syntaxe

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

Paramètres

[in] piData

Pointeur d’interface IUnknown pour récupérer des informations relatives au nouvel élément de menu. En appelant la méthode IUnknown::QueryInterface avec le pointeur piData , les interfaces suivantes sont disponibles :

Selon le type d’objet de cluster pour lequel le menu contextuel est créé, l’une des interfaces suivantes peut également être disponible :

IGetClusterNodeInfo, si l’élément de menu concerne un nœud.
IGetClusterGroupInfo, si l’élément de menu concerne un groupe.
IGetClusterNetworkInfo, si l’élément de menu concerne un réseau.
IGetClusterNetInterfaceInfo, si l’élément de menu concerne une interface réseau.
IGetClusterResourceInfo, si l’élément de menu concerne une ressource.

[in] piCallback

Pointeur vers une implémentation de l’interface IWCContextMenuCallback pour ajouter de nouveaux éléments au menu contextuel Administrateur de cluster.

Valeur retournée

Retourne l’une des valeurs suivantes ou toute VALEUR HRESULT qui décrit les résultats de l’opération.

Code/valeur de retour	Description
NOERROR 0	L'opération a réussi.
E_INVALIDARG 0x80070057	Au moins un des paramètres n’est pas valide.
E_NOTIMPL 0x80004001	L’extension ne prend pas en charge l’ajout d’éléments de menu contextuel.

Remarques

Pour implémenter AddContextMenuItems

Appelez la méthode IUnknown::QueryInterface pointée vers piData pour récupérer un pointeur vers une interface qui peut fournir des informations sur l’objet associé à l’élément de menu.
Appelez la méthode IWCContextMenuCallback::AddExtensionMenuItem à l’aide du pointeur piCallback pour ajouter l’élément au menu.

Pour ajouter des éléments de menu contextuel et implémenter du code qui s’exécute lorsque vos éléments de menu contextuel sont sélectionnés, implémentez la méthode IWEInvokeCommand::InvokeCommand .

Configuration requise


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 Entreprise, Windows Server 2003 Datacenter
Plateforme cible	Windows
En-tête	cluadmex.h