IWEInvokeCommand::InvokeCommand 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 implement procedures that execute when users select your context menu items.

Syntax

HRESULT InvokeCommand(
  [in] ULONG    nCommandID,
  [in] IUnknown *piData
);

Parameters

[in] nCommandID

Identifier of the menu item containing the command to perform. The identifier represented by nCommandID is the identifier passed to the IWCContextMenuCallback::AddExtensionMenuItem method.

[in] piData

IUnknown interface pointer for retrieving information associated with the command identified by nCommandID. By calling the IUnknown::QueryInterface method with the piData pointer, the following interfaces are available:

Depending on the type of cluster object to which the context menu item applies, a pointer to one of the following interfaces is also available:

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

Return value

Returns 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_NOTIMPL 0x80004001	The operation is not implemented by this method.

Remarks

To create context menu items and add them to Failover Cluster Administrator, use the IWEExtendContextMenu::AddContextMenuItems 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