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 。
傳回碼/值 | Description |
---|---|
|
作業成功。 |
|
至少有一個參數無效。 |
|
擴充功能不支援新增屬性頁。 |
備註
故障轉移叢集管理員 會呼叫延伸模組的 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 |