傳回目前叢集 節點的唯一標識符。
語法
DWORD GetCurrentClusterNodeId(
[out] LPWSTR _lpszNodeId,
[in, out] LPDWORD _lpcchName_
);
參數
[out] _lpszNodeId_
此參數指向接收 hNode 唯一標識符的緩衝區,包括終止 的 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 |
| 目標平臺 | 窗戶 |
| 頁首 | clusapi.h |