IWEExtendWizard::CreateWizardPages 方法 (cluadmex.h)
[此方法可用于“要求”部分中指定的操作系统。 Windows Server 2008 中删除了对此方法的支持。]
允许创建向导页,并将其添加到 故障转移群集管理员的 “新建资源向导”或“群集应用程序向导”。
语法
HRESULT CreateWizardPages(
[in] IUnknown *piData,
[in] IWCWizardCallback *piCallback
);
参数
[in] piData
IUnknown 接口指针,用于检索与要添加的向导页相关的信息。 通过使用 piData 指针调用 IUnknown::QueryInterface,可以使用以下接口:
根据要为其创建向导页的 群集对象的 类型,还可以使用指向以下接口之一的指针:- IGetClusterNodeInfo,如果属性页与 节点相关。
- IGetClusterGroupInfo,如果属性页与 组相关。
- IGetClusterNetworkInfo,如果属性页与 网络相关。
- IGetClusterNetInterfaceInfo,如果属性页与 网络接口相关。
- IGetClusterResourceInfo,如果属性页与 资源相关。
[in] piCallback
指向用于将新属性页添加到向导的 IWCWizardCallback 接口实现的指针。
返回值
返回以下值之一或描述操作结果的任何 HRESULT 。
返回代码/值 | 说明 |
---|---|
|
操作成功。 |
|
至少有一个参数无效。 |
|
该扩展不支持将属性页添加到“创建组向导”或“创建资源向导”。 |
注解
若要添加 Wizard97 向导页,请使用 IWEExtendWizard97::CreateWizard97Pages 方法。
实施者说明
对于要添加的每个属性页
- 使用 piData 调用 QueryInterface 并检索与新页面关联的 群集对象的 接口指针。 例如,如果要为资源添加属性页,则希望检索指向 IGetClusterResourceInfo 接口的指针。 尽管可以成功查询检索与所扩展的对象无关的数据的接口,但尝试调用方法时应会收到错误。
-
若要创建页面,请调用函数 CreatePropertySheetPage。 若要生成类似于群集管理员提供的页面的页面,每个新属性页的宽度不应大于 252 个对话框单元和 218 个对话框单元,并且应包含两个标准控件:
- 对于对象图标,图标控件位于 (8,7) ,大小为 (18,20) 。
- 对于对象名称,静态控件位于 (38,12) ,大小为 (247,10) 。
- 若要将页面添加到群集管理员向导,请使用 piCallback 指针调用 IWCWizardCallback::AddWizardPage。
要求
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2003 企业版、Windows Server 2003 Datacenter |
目标平台 | Windows |
标头 | cluadmex.h |