IWEExtendWizard::CreateWizardPages

The IWEExtendWizard::CreateWizardPages method creates property pages and adds them to the Create Group or Create Resource Wizard.

HRESULT CreateWizardPages(
  IUnknown *piData,               
  IWCWizardCallback *piCallback   
);
 

Parameters

piData

[in] Pointer to an IUnknown interface implementation that can be used to obtain pointers to interface implementations relating to the object associated with the new property page. When Cluster Administrator uses piData to call IUnknown::QueryInterface, it should be able to retrieve a pointer to these interfaces:

IGetClusterUIInfo

IGetClusterDataInfo

IGetClusterObjectInfo

Depending on the type of object to appear in the new property page, an extension should also make a pointer available to one of these interfaces:

IGetClusterNodeInfo, if the cluster component is a node.

IGetClusterGroupInfo, if the cluster component is a group.

IGetClusterResourceInfo, if the cluster component is a resource.

piCallback

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

Return Values

NOERROR

The operation was successful.

E_INVALIDARG

One or both of the parameters was invalid.

E_OUTOFMEMORY

The operation failed due to insufficient memory.

E_FAIL

A property page could not be created.

E_NOTIMPL

The extension does not support adding a property page to the Create Group or Create Resource Wizard.

If the operation was unsuccessful, CreateWizardPages can also return an OLE-defined error value.

Remarks

Cluster Administrator calls IWEExtendWizard::CreateWizardPages to extend the Create Group or Create Resource Wizard whenever the user creates a new group or a new resource.

Notes to Implementers

    For each property page to be added

1. Call the IUnknown::QueryInterface method of the interface pointed to by piData to retrieve a pointer to an interface that can provide information about the object associated with the new page.
2. Call the Win32 function CreatePropertySheetPage to create the page.
3. Call IWCPropertySheetCallback::AddPropertySheetPage using the piCallback pointer to add the page to the Cluster Administrator Wizard.

Each new property page should be no larger than 293 dialog units wide and 172 dialog units high and contain two standard controls:

• Icon control positioned at (8,7) with a size of (18,20).
• Static control positioned at (38,12) with a size of (247,10).

These guidelines result in an extension's pages having a similar appearance to the pages provided by Cluster Administrator.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in cluadmex.h.