CreateCluster 函式 (clusapi.h)
建立並啟動叢集。 叢集是由指定的節點集所組成,其中指定 了網路名稱、 IP 位址和 仲裁資源 。 PCLUSAPI_CREATE_CLUSTER類型會定義此函式的指標。
語法
HCLUSTER CreateCluster(
[in] PCREATE_CLUSTER_CONFIG pConfig,
[in, optional] PCLUSTER_SETUP_PROGRESS_CALLBACK pfnProgressCallback,
[in, optional] PVOID pvCallbackArg
);
參數
[in] pConfig
包含要建立之叢集之組態資訊的 CREATE_CLUSTER_CONFIG 結構位址。
[in, optional] pfnProgressCallback
回呼函式的位址,其符合將定期呼叫 的PCLUSTER_SETUP_PROGRESS_CALLBACK 函式指標,以提供叢集建立的進度。
[in, optional] pvCallbackArg
回呼函式的自變數。
傳回值
處理新建立的叢集或 NULL。 非 NULL 值並不表示所有節點都已新增 (完成成功,但尚未建立所有 IP 位址 或 網路名稱 資源。 應該檢查傳遞給 pfnProgressCallback 參數所指向之函式的參數。
傳回碼 | Description |
---|---|
|
已成功建立大部分的節點。 如需錯誤的詳細資訊,請呼叫 函式 GetLastError。 |
備註
PCLUSAPI_CREATE_CLUSTER類型會定義此函式的指標,並可搭配 GetProcAddress 函式使用,以呼叫此函式。
CreateCluster 函式成功完成之後,至少應該允許 30 秒,再呼叫 AddClusterNode 函式以新增其他節點。
在完成叢集仲裁之後, CreateCluster 函式會成功完成。 一或多個叢集節點可能處於 ClusterNodeDown 或 ClusterNodeJoining 狀態幾秒鐘。
呼叫 CreateCluster 函式之前,必須先呼叫 CoInitializeEx 函式,以指定 dwCoInit 參數的COINIT_MULTITHREADED和COINIT_DISABLE_OLE1DDE,如下列程式代碼所示。
CoInitializeEx( NULL, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE );
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2008 Datacenter、Windows Server 2008 企業版 |
目標平台 | Windows |
標頭 | clusapi.h |
程式庫 | ClusAPI.lib |
Dll | ClusAPI.dll |