GetNodeClusterState 函数 (clusapi.h)

确定是否在节点上安装并运行群集服务PCLUSAPI_GET_NODE_CLUSTER_STATE类型定义指向此函数的指针。

语法

DWORD GetNodeClusterState(
  [in, optional] LPCWSTR lpszNodeName,
  [out]          LPDWORD pdwClusterState
);

参数

[in, optional] lpszNodeName

指向以 null 结尾的 Unicode 字符串的指针,该字符串包含要查询的节点的名称。 如果 lpszNodeNameNULL,则查询本地节点。

[out] pdwClusterState

指向描述节点上群集服务状态的值的指针。 节点将由以下 NODE_CLUSTER_STATE 枚举值之一描述。

ClusterStateNotInstalled (0)

节点上未安装群集服务。

ClusterStateNotConfigured (1)

群集服务已安装在节点上,但尚未配置。

ClusterStateNotRunning (3)

群集服务已在节点上安装和配置,但当前未运行。

ClusterStateRunning (19 (0x13) )

群集服务在节点上安装、配置和运行。

返回值

如果操作成功,函数将返回 ERROR_SUCCESS ( 0) 。 如果操作失败,函数将返回 系统错误代码

注解

注意 如果调用的应用程序是基于 32 位 Windows 的, 则 GetNodeClusterState 函数不支持基于 64 位 Windows 的 节点

要求

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

另请参阅

NODE_CLUSTER_STATE

节点管理功能