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 。
傳回碼/值 | Description |
---|---|
|
作業成功。 |
|
至少有一個參數無效。 |
|
擴充功能不支援將屬性頁新增至 [建立群組精靈] 或 [建立資源精靈]。 |
備註
若要新增 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 |