IWEExtendWizard97::CreateWizard97Pages 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 Wizard97 property pages and add them to a Failover Cluster Administrator Wizard.

Syntax

HRESULT CreateWizard97Pages(
  [in] IUnknown            *piData,
  [in] IWCWizard97Callback *piCallback
);

Parameters

[in] piData

IUnknown interface pointer for retrieving information relating to the wizard97 pages to be added. By calling IUnknown::QueryInterface with the piData pointer, the following interfaces are available:

Depending on the type of cluster object, 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.

[in] piCallback

Pointer to an IWCWizard97Callback interface implementation used to add the new Wizard97 property pages to the wizard.

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 Wizard97 pages.

Remarks

Notes to Implementers

If your extension has no Wizard97 pages but does have non-Wizard97 pages, you can either:

Support only the IWEExtendWizard interface.
Support both the IWEExtendWizard and IWEExtendWizard97 interfaces, but in your implementation of IWEExtendWizard97, query for the IWCWizardCallback interface from the interface passed in by way of the piCallback parameter.

For each Wizard97 property page to be added

Use piData to call QueryInterface and retrieve an interface pointer for the object associated with the new page. For example, if you are adding a property page for a resource, you want to retrieve a pointer to the IGetClusterResourceInfo interface. Although it is possible to successfully query for interfaces that retrieve data unrelated to the object being extended, you should expect to receive errors when you attempt to call the methods.
To create the page, call the function CreatePropertySheetPage. To produce pages that look like the pages provided by Cluster Administrator, each new wizard97 page should be no larger than 293 dialog units wide and 172 dialog units high, and should contain a static control positioned at (38,12) with a size of (247,10).
To add the page to a Cluster Administrator Wizard, call IWCWizard97Callback::AddWizard97Page using the piCallback pointer.

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