共用方式為

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 函式在達成叢集法定人數後才會成功完成。 一個或多個叢集節點可能會處於 ClusterNodeDown 或 ClusterNodeJoining 狀態，持續數秒鐘。

在呼叫 CreateCluster 函式之前，必須先呼叫 CoInitializeEx 函式，並指定 dwCoInit 參數的 COINIT_MULTITHREADED 與 COINIT_DISABLE_OLE1DDE，如下程式碼所示。

CoInitializeEx( NULL, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE );

需求

Requirement 價值觀
最低支援的用戶端 不支援
支援的最低伺服器 Windows Server 2008 Datacenter、Windows Server 2008 Enterprise
目標平臺 窗戶
Header Clusapi.h
Library ClusAPI.lib
DLL ClusAPI.dll

另請參閱

AddClusterNode

CREATE_CLUSTER_CONFIG

叢集管理功能

摧毀集群

PCLUSTER_SETUP_PROGRESS_CALLBACK

  • Last updated on