IWEExtendContextMenu::AddContextMenuItems method (cluadmex.h)

Article
10/13/2021

[This method is available for use in the operating systems specified in the Requirements section. Support for this method was removed in Windows Server 2008.]

Allows you to create context menu items for a cluster object and add the items to a Failover Cluster Administrator context menu.

Syntax

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

Parameters

[in] piData

IUnknown interface pointer for retrieving information relating to the new menu item. By calling the IUnknown::QueryInterface method with the piData pointer, the following interfaces are available:

Depending on the type of cluster object for which the context menu is being created, one of the following interfaces may also be available:

IGetClusterNodeInfo, if the menu item relates to a node.
IGetClusterGroupInfo, if the menu item relates to a group.
IGetClusterNetworkInfo, if the menu item relates to a network.
IGetClusterNetInterfaceInfo, if the menu item relates to a network interface.
IGetClusterResourceInfo, if the menu item relates to a resource.

[in] piCallback

Pointer to an IWCContextMenuCallback interface implementation for adding new items to the Cluster Administrator context menu.

Return value

Return one of the following values or any HRESULT that describes the results of the operation.

Return code/value	Description
NOERROR 0	The operation was successful.
E_INVALIDARG 0x80070057	At least one of the parameters is invalid.
E_NOTIMPL 0x80004001	The extension does not support adding context menu items.

Remarks

To implement AddContextMenuItems

Call the IUnknown::QueryInterface method pointed to by piData to retrieve a pointer to an interface that can provide information about the object associated with the menu item.
Call the IWCContextMenuCallback::AddExtensionMenuItem method using the piCallback pointer to add the item to the menu.

To add context menu items and to implement code that executes when your context menu items are selected, implement the IWEInvokeCommand::InvokeCommand method.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2003 Enterprise, Windows Server 2003 Datacenter
Target Platform	Windows
Header	cluadmex.h