返回当前群集 节点的唯一标识符。
语法
DWORD GetCurrentClusterNodeId(
[out] LPWSTR _lpszNodeId,
[in, out] LPDWORD _lpcchName_
);
参数
[out] _lpszNodeId_
此参数指向接收 hNode 的唯一 ID 的缓冲区,包括终止 NULL 字符。
[in, out] _lpcchName_
在输入时,指向 lpszNodeId 参数指向的缓冲区中的字符计数的指针,包括 NULL 终止符。 在输出中,指向从 NULL 终止符排除的缓冲区中存储的字符计数的指针。
返回值
类型:DWORD
此函数返回 系统错误代码。 下面是可能的值:
-
ERROR_SUCCESS
- 0 (0x0)
- 作已成功完成。
-
ERROR_MORE_DATA
- 234 (0xEA)
- 提供了更多数据。
- 如果 _lpszNodeId_ 指向的缓冲区不够长,无法容纳所需的字符数,则返回此值。 GetCurrentClusterNodeId 将 _lpcchName_ 的内容设置为所需的长度。
注解
请注意, lpcchName 是指字符计数,而不是字节计数,并且返回的大小不包括计数中的终止 NULL 。 有关大小调整缓冲区的详细信息,请参阅 数据大小约定。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 无受支持的版本 |
| 支持的最低服务器 | Windows Server 2008 企业版、Windows Server 2008 Datacenter |
| 目标平台 | Windows操作系统 |
| 标头 | clusapi.h |