IWEExtendWizard::CreateWizardPages method

[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 wizard pages and add them to Failover Cluster Administrator's New Resource Wizard or Cluster Application Wizard.

Syntax


HRESULT CreateWizardPages(
  [in] IUnknown          *piData,
  [in] IWCWizardCallback *piCallback
);

Parameters

piData [in]

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

Depending on the type of cluster object for which the wizard page is being created, a pointer to one of the following interfaces is also available:

piCallback [in]

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

Return value

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

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 a property page to the Create Group Wizard or Create Resource Wizard.

Remarks

To add Wizard97 wizard pages, use the IWEExtendWizard97::CreateWizard97Pages method.

Notes to Implementers

Aa370738.wedge(en-us,VS.85).gifFor each property page to be added

  1. Use piData to call QueryInterface and retrieve an interface pointer for the cluster 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.
  2. To create the page, call the function CreatePropertySheetPage. To produce pages that look like the pages provided by Cluster Administrator, each new property page should be no larger than 252 dialog units wide and 218 dialog units high, and should contain two standard controls:

    • For the object icon, an icon control positioned at (8,7) with a size of (18,20).
    • For the object name, a static control positioned at (38,12) with a size of (247,10).
  3. To add the page to a Cluster Administrator Wizard, call IWCWizardCallback::AddWizardPage using the piCallback pointer.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2003 Enterprise, Windows Server 2003 Datacenter

End of server support

Windows Server 2003 Datacenter, Windows Server 2003 Enterprise

IDL

CluAdmEx.idl

IID

IID_IWEExtendWizard is defined as 97DEDE63-FC6B-11CF-B5F5-00A0C90AB505

See also

IGetClusterDataInfo
IGetClusterGroupInfo
IGetClusterNetInterfaceInfo
IGetClusterNetworkInfo
IGetClusterNodeInfo
IGetClusterObjectInfo
IGetClusterResourceInfo
IGetClusterUIInfo
IWCWizardCallback
IWCPropertySheetCallback::AddPropertySheetPage
IWEExtendWizard
IWEExtendWizard97
IWEExtendWizard97::CreateWizard97Pages

 

 

Show: