共用方式為

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 唯一標識符的緩衝區，包括終止 的 NULL 字元。

[in, out] lpcchName

在輸入時，指標指向 lpszNodeId 參數所指向緩衝區中的字元計數，包括 NULL 終止符。 在輸出時，指標指向儲存在緩衝區中，不包括 NULL 終止符的字元計數。

傳回值

此函式會傳回 系統錯誤碼。 以下是可能的值：

傳回碼/值 Description
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 Enterprise、Windows Server 2008 Datacenter
目標平台 Windows
標頭 clusapi.h
程式庫 ClusAPI.lib
Dll ClusAPI.dll

另請參閱

GetCurrentClusterNodeId

節點管理功能

OpenClusterNode