通过

GetClusterGroupState 函数 (clusapi.h)

  • 项目

返回 组的当前状态。 PCLUSAPI_GET_CLUSTER_GROUP_STATE类型定义指向此函数的指针。

语法

CLUSTER_GROUP_STATE GetClusterGroupState(
  [in]                HGROUP  hGroup,
  [out, optional]     LPWSTR  lpszNodeName,
  [in, out, optional] LPDWORD lpcchNodeName
);

参数

[in] hGroup

应为其返回状态信息的组的句柄。

[out, optional] lpszNodeName

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含当前拥有该组的节点的名称。

[in, out, optional] lpcchNodeName

指向以字符计数表示的 lpszNodeName 缓冲区大小的指针。 输入时，指定缓冲区可以容纳的最大字符数，包括终止 NULL。 在输出时，指定结果名称中的字符数，不包括终止 NULL。

返回值

GetClusterGroupState 返回组的当前状态，该状态由以下值之一表示。

返回代码/值 说明
ClusterGroupStateUnknown
-1
 操作未成功。 有关错误的详细信息，请调用函数 GetLastError。
ClusterGroupOnline
0
 组中的所有资源都 处于联机状态。
ClusterGroupOffline
1
 组中的所有资源都 处于脱机状态 ，或者组中没有资源。
ClusterGroupFailed
2
 组中至少有一个资源失败， (从 CLUSTER_RESOURCE_STATE 枚举) 将 ClusterResourceFailed 的状态设置为 ClusterResourceFailed。
ClusterGroupPartialOnline
3
 组中至少有一个资源处于联机状态。 没有资源 挂起 或 失败。
ClusterGroupPending
4
 组中至少有一个资源处于挂起状态。 没有失败的资源。

注解

请注意， lpcchName 指的是字符计数，而不是字节计数，并且返回的大小不包括计数中的终止 NULL 。 有关调整缓冲区大小的详细信息，请参阅 数据大小约定。

不要从任何资源 DLL 入口点函数调用 GetClusterGroupState 。 可以从工作线程安全地调用 GetClusterGroupState。 有关详细信息，请参阅 资源 DLL 中对避免的函数调用。

要求

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

另请参阅

CLUSTER_GROUP_STATE

CLUSTER_RESOURCE_STATE

组管理功能

OpenClusterGroup