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 参数指向的函数的参数。
返回代码 | 说明 |
---|---|
|
成功创建的节点少于大多数。 有关错误的详细信息,请调用函数 GetLastError。 |
注解
PCLUSAPI_CREATE_CLUSTER类型定义指向此函数的指针,可与 GetProcAddress 函数一起使用来调用此函数。
CreateCluster 函数成功完成后,应至少允许 30 秒,然后才能调用 AddClusterNode 函数以添加其他节点。
在实现群集仲裁后, CreateCluster 函数成功完成。 一个或多个群集节点可能处于 ClusterNodeDown 或 ClusterNodeJoining 状态几秒钟。
在调用 CreateCluster 函数之前,必须调用 CoInitializeEx 函数,同时为 dwCoIninit 参数指定COINIT_MULTITHREADED和COINIT_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 |