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