IWEExtendContextMenu::AddContextMenuItems method (cluadmex.h)

[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:

[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

  1. 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.
  2. 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

See also

IGetClusterDataInfo

IGetClusterGroupInfo

IGetClusterNetInterfaceInfo

IGetClusterNetworkInfo

IGetClusterNodeInfo

IGetClusterObjectInfo

IGetClusterResourceInfo

IGetClusterUIInfo

IWCContextMenuCallback

IWCContextMenuCallback::AddExtensionMenuItem

IWEExtendContextMenu

IWEInvokeCommand::InvokeCommand