共用方式為


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
NULL
已成功建立大部分的節點。 如需錯誤的詳細資訊,請呼叫 函式 GetLastError

備註

PCLUSAPI_CREATE_CLUSTER類型會定義此函式的指標,並可搭配 GetProcAddress 函式使用,以呼叫此函式。

CreateCluster 函式成功完成之後,至少應該允許 30 秒,再呼叫 AddClusterNode 函式以新增其他節點。

在完成叢集仲裁之後, CreateCluster 函式會成功完成。 一或多個叢集節點可能處於 ClusterNodeDownClusterNodeJoining 狀態幾秒鐘。

呼叫 CreateCluster 函式之前,必須先呼叫 CoInitializeEx 函式,以指定 dwCoInit 參數的COINIT_MULTITHREADEDCOINIT_DISABLE_OLE1DDE,如下列程式代碼所示。

CoInitializeEx( NULL, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE );

規格需求

需求
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008 Datacenter、Windows Server 2008 企業版
目標平台 Windows
標頭 clusapi.h
程式庫 ClusAPI.lib
Dll ClusAPI.dll

另請參閱

AddClusterNode

CREATE_CLUSTER_CONFIG

叢集管理功能

DestroyCluster

PCLUSTER_SETUP_PROGRESS_CALLBACK