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:- 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 |
---|---|
|
The operation was successful. |
|
At least one of the parameters is invalid. |
|
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.
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 |