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 参数指向的函数的参数。

返回代码 说明
NULL
成功创建的节点少于大多数。 有关错误的详细信息,请调用函数 GetLastError

注解

PCLUSAPI_CREATE_CLUSTER类型定义指向此函数的指针,可与 GetProcAddress 函数一起使用来调用此函数。

CreateCluster 函数成功完成后,应至少允许 30 秒,然后才能调用 AddClusterNode 函数以添加其他节点。

在实现群集仲裁后, CreateCluster 函数成功完成。 一个或多个群集节点可能处于 ClusterNodeDownClusterNodeJoining 状态几秒钟。

在调用 CreateCluster 函数之前,必须调用 CoInitializeEx 函数,同时为 dwCoIninit 参数指定COINIT_MULTITHREADEDCOINIT_DISABLE_OLE1DDE,如以下代码所示。

CoInitializeEx( NULL, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE );

要求

要求
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008 Datacenter、Windows Server 2008 Enterprise
目标平台 Windows
标头 clusapi.h
Library ClusAPI.lib
DLL ClusAPI.dll

另请参阅

AddClusterNode

CREATE_CLUSTER_CONFIG

群集管理功能

DestroyCluster

PCLUSTER_SETUP_PROGRESS_CALLBACK