openClusterNodeEx 函式 (clusapi.h)
開啟 節點 並傳回控制碼。
語法
HNODE OpenClusterNodeEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszNodeName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
參數
[in] hCluster
從OpenCluster或OpenClusterEx函式傳回的叢集控制碼。
[in, optional] lpszNodeName
現有節點之 NetBIOS 名稱的指標。 如果使用節點的 DNS 名稱， OpenClusterNodeEx 函式將會失敗，而且 GetLastError 會 傳回ERROR_CLUSTER_NODE_NOT_FOUND。
[in] dwDesiredAccess
要求的存取許可權。 這可能是 GENERIC_READ (0x80000000) 、 GENERIC_ALL (0x10000000) 或 MAXIMUM_ALLOWED (0x02000000) 的任何組合。 如果此值為零 (0) ，則可能會傳回未定義的錯誤。 使用 GENERIC_ALL 與呼叫 OpenClusterNode相同。
[out, optional] lpdwGrantedAccess
選擇性參數，其中包含將接收授與存取權限的 DWORD 位址。 如果 DesiredAccess 參數 MAXIMUM_ALLOWED (0x02000000) 則此參數所指向的 DWORD 將會包含授與此使用者的最大許可權。
傳回值
如果作業成功， OpenClusterNodeEx 會 傳回節點控制碼。
| 傳回碼 | Description |
|---|---|
|
作業未成功。 如需錯誤的詳細資訊，請呼叫 GetLastError 函 式。 如果目標伺服器不支援 OpenClusterNodeEx 函式 (例如，如果目標伺服器執行 Windows Server 2008 或更早版本) ， GetLastError 函式會傳回 RPC_S_PROCNUM_OUT_OF_RANGE (1745) 。 |
規格需求
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2008 R2 Datacenter、Windows Server 2008 R2 Enterprise |
| 目標平台 | Windows |
| 標頭 | clusapi.h |
| 程式庫 | ClusAPI.lib |
| Dll | ClusAPI.dll |