通过

getClusterNodeId 函数 (clusapi.h)

  • 项目

返回群集 节点的唯一标识符。 PCLUSAPI_GET_CLUSTER_NODE_ID类型定义指向此函数的指针。

语法

DWORD GetClusterNodeId(
  [in, optional] HNODE   hNode,
  [out]          LPWSTR  lpszNodeId,
  [in, out]      LPDWORD lpcchName
);

参数

[in, optional] hNode

要返回的标识符为 NULL 的节点的句柄。 如果 hNode 设置为 NULL，则会在 lpszNodeId 的内容中返回运行应用程序的节点的节点标识符。

[out] lpszNodeId

此参数指向接收 hNode 的唯一 ID 的缓冲区，包括终止 NULL 字符。

[in, out] lpcchName

输入时，指针指向 lpszNodeId 参数指向的缓冲区中的字符计数，包括 NULL 终止符。 输出时，指针指向缓冲区中存储的字符计数（不包括 NULL 终止符）。

返回值

此函数返回 系统错误代码。 下面是可能的值：

返回代码/值 说明
ERROR_SUCCESS
0
 操作已成功完成。
ERROR_MORE_DATA
234 (0xEA)
 更多数据可用。 如果 lpszNodeId 指向的缓冲区长度不足以容纳所需的字符数，则返回此值。 GetClusterNodeId 将 lpcchName 的内容设置为所需的长度。

注解

PCLUSAPI_GET_CLUSTER_NODE_ID类型定义指向此函数的指针。

如果 hNode 设置为 NULL ，并且调用方在活动群集节点上运行， 则 GetClusterNodeId 函数将返回运行应用程序的节点的标识符。 将 hNode 设置为 NULL 是 资源 DLL 确定运行它们的节点的节点标识符的一种便捷方法。 可以使用 GetCurrentClusterNodeId 宏，而不是为 hNode 参数传递 NULL。

群集节点标识符是一个唯一标识符，即使更改节点的名称也不会更改。

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

要求

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

另请参阅

GetCurrentClusterNodeId

节点管理功能

OpenClusterNode