IWEExtendPropertySheet::CreatePropertySheetPages method

Creates property pages for a cluster object and adds them to a Failover Cluster Administrator property sheet.

Syntax

HRESULT CreatePropertySheetPages(
  IUnknown                 *piData,
  IWCPropertySheetCallback *piCallback
);

Parameters

piData

IUnknown interface pointer for retrieving information relating to the new property pages. By calling the IUnknown::QueryInterface method with the piData pointer, the following interfaces are available:

Depending on the type of cluster object for which property sheet pages are being created, a pointer to one of the following interfaces is also available:

piCallback

Pointer to an IWCPropertySheetCallback interface implementation for adding property pages to the Cluster Administrator property sheet.

Return Value

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

Remarks

Failover Cluster Administrator calls an extension's CreatePropertySheetPages method to extend a property sheet to handle an additional cluster object.

Notes to Implementers

For each property page to be added

  1. Use piData to call QueryInterface and retrieve an interface pointer for the cluster object associated with the 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 target object, 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 (206,10).
  3. To add the page to the property sheet, call the IWCPropertySheetCallback::AddPropertySheetPage method pointed to by piCallback.

Requirements

   
Windows version None supported Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Target Platform Windows
Header cluadmex.h

See Also

IGetClusterDataInfo

IGetClusterGroupInfo

IGetClusterNetInterfaceInfo

IGetClusterNetworkInfo

IGetClusterNodeInfo

IGetClusterObjectInfo

IGetClusterResourceInfo

IGetClusterUIInfo

IWCPropertySheetCallback

IWCPropertySheetCallback::AddPropertySheetPage

IWEExtendPropertySheet