IWEExtendContextMenu::AddContextMenuItems-Methode (cluadmex.h)

Artikel
08/22/2023

[Diese Methode ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Die Unterstützung für diese Methode wurde in Windows Server 2008 entfernt.]

Ermöglicht ihnen das Erstellen von Kontextmenüelementen für ein Clusterobjekt und das Hinzufügen der Elemente zum Kontextmenü des Failoverclusteradministrators .

Syntax

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

Parameter

[in] piData

IUnknown-Schnittstellenzeiger zum Abrufen von Informationen im Zusammenhang mit dem neuen Menüelement. Durch Aufrufen der IUnknown::QueryInterface-Methode mit dem piData-Zeiger stehen die folgenden Schnittstellen zur Verfügung:

Abhängig vom Typ des Clusterobjekts , für das das Kontextmenü erstellt wird, kann auch eine der folgenden Schnittstellen verfügbar sein:

IGetClusterNodeInfo, wenn sich das Menüelement auf einen Knoten bezieht.
IGetClusterGroupInfo, wenn sich das Menüelement auf eine Gruppe bezieht.
IGetClusterNetworkInfo, wenn sich das Menüelement auf ein Netzwerk bezieht.
IGetClusterNetInterfaceInfo, wenn sich das Menüelement auf eine Netzwerkschnittstelle bezieht.
IGetClusterResourceInfo, wenn sich das Menüelement auf eine Ressource bezieht.

[in] piCallback

Zeiger auf eine IWCContextMenuCallback-Schnittstellenimplementierung zum Hinzufügen neuer Elemente zum Kontextmenü des Clusteradministrators.

Rückgabewert

Gibt einen der folgenden Werte oder ein beliebiges HRESULT zurück, das die Ergebnisse des Vorgangs beschreibt.

Rückgabecode/-wert	BESCHREIBUNG
NOERROR 0	Der Vorgang wurde durchgeführt.
E_INVALIDARG 0x80070057	Mindestens einer der Parameter ist ungültig.
E_NOTIMPL 0x80004001	Die Erweiterung unterstützt das Hinzufügen von Kontextmenüelementen nicht.

Hinweise

So implementieren Sie AddContextMenuItems

Rufen Sie die IUnknown::QueryInterface-Methode auf, auf die piData verweist, um einen Zeiger auf eine Schnittstelle abzurufen, die Informationen zu dem Dem Menüelement zugeordneten Objekt bereitstellen kann.
Rufen Sie die IWCContextMenuCallback::AddExtensionMenuItem-Methode auf, indem Sie den piCallback-Zeiger verwenden, um das Element zum Menü hinzuzufügen.

Um Kontextmenüelemente hinzuzufügen und Code zu implementieren, der ausgeführt wird, wenn Ihre Kontextmenüelemente ausgewählt sind, implementieren Sie die IWEInvokeCommand::InvokeCommand-Methode .

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 Enterprise, Windows Server 2003 Datacenter
Zielplattform	Windows
Kopfzeile	cluadmex.h