IWEExtendWizard::CreateWizardPages 方法 (cluadmex.h)

[此方法可用于“要求”部分中指定的操作系统。 Windows Server 2008 中删除了对此方法的支持。]

允许创建向导页,并将其添加到 故障转移群集管理员的 “新建资源向导”或“群集应用程序向导”。

语法

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

参数

[in] piData

IUnknown 接口指针,用于检索与要添加的向导页相关的信息。 通过使用 piData 指针调用 IUnknown::QueryInterface,可以使用以下接口:

根据要为其创建向导页的 群集对象的 类型,还可以使用指向以下接口之一的指针:

[in] piCallback

指向用于将新属性页添加到向导的 IWCWizardCallback 接口实现的指针。

返回值

返回以下值之一或描述操作结果的任何 HRESULT

返回代码/值 说明
NOERROR
0
操作成功。
E_INVALIDARG
0x80070057
至少有一个参数无效。
E_NOTIMPL
0x80004001
该扩展不支持将属性页添加到“创建组向导”或“创建资源向导”。

注解

若要添加 Wizard97 向导页,请使用 IWEExtendWizard97::CreateWizard97Pages 方法。

实施者说明

对于要添加的每个属性页

  1. 使用 piData 调用 QueryInterface 并检索与新页面关联的 群集对象的 接口指针。 例如,如果要为资源添加属性页,则希望检索指向 IGetClusterResourceInfo 接口的指针。 尽管可以成功查询检索与所扩展的对象无关的数据的接口,但尝试调用方法时应会收到错误。
  2. 若要创建页面,请调用函数 CreatePropertySheetPage。 若要生成类似于群集管理员提供的页面的页面,每个新属性页的宽度不应大于 252 个对话框单元和 218 个对话框单元,并且应包含两个标准控件:
    • 对于对象图标,图标控件位于 (8,7) ,大小为 (18,20) 。
    • 对于对象名称,静态控件位于 (38,12) ,大小为 (247,10) 。
  3. 若要将页面添加到群集管理员向导,请使用 piCallback 指针调用 IWCWizardCallback::AddWizardPage

要求

   
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2003 企业版、Windows Server 2003 Datacenter
目标平台 Windows
标头 cluadmex.h

另请参阅

IGetClusterDataInfo

IGetClusterGroupInfo

IGetClusterNetInterfaceInfo

IGetClusterNetworkInfo

IGetClusterNodeInfo

IGetClusterObjectInfo

IGetClusterResourceInfo

IGetClusterUIInfo

IWCPropertySheetCallback::AddPropertySheetPage

IWCWizardCallback

IWEExtendWizard

IWEExtendWizard97

IWEExtendWizard97::CreateWizard97Pages