通过

GetClusterInformation 函数 (clusapi.h)

  • 项目

检索 群集的名称 和版本。 PCLUSAPI_GET_CLUSTER_INFORMATION类型定义指向此函数的指针。

语法

DWORD GetClusterInformation(
  [in]            HCLUSTER             hCluster,
  [out]           LPWSTR               lpszClusterName,
  [in, out]       LPDWORD              lpcchClusterName,
  [out, optional] LPCLUSTERVERSIONINFO lpClusterInfo
);

参数

[in] hCluster

群集的句柄。

[out] lpszClusterName

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含 由 hCluster 标识的群集的名称。

[in, out] lpcchClusterName

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

[out, optional] lpClusterInfo

NULL 或指向描述群集服务版本的 CLUSTERVERSIONINFO 结构的指针。 当 lpClusterInfo 不为 NULL 时，应按如下所示设置此结构的 dwVersionInfoSize 成员： lpClusterInfo->dwVersionInfoSize = sizeof(CLUSTERVERSIONINFO);

返回值

如果操作成功，函数将返回 ERROR_SUCCESS ( 0) 。

如果操作失败，函数将返回 系统错误代码。 下面是可能的值之一。

返回代码 说明
ERROR_MORE_DATA
 lpszClusterName 指向的缓冲区不够大，无法保存结果。 lpcchClusterName 参数返回结果中的字符数，不包括终止 NULL。

注解

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

要求

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

另请参阅

CLUSTERVERSIONINFO