共用方式為

OpenClusterEx 函式 (clusapi.h)

  • 發行項

開啟 叢集 的連線，並傳回它的句柄。

語法

HCLUSTER OpenClusterEx(
  [in, optional]  LPCWSTR lpszClusterName,
  [in]            DWORD   DesiredAccess,
  [out, optional] DWORD   *GrantedAccess
);

參數

[in, optional] lpszClusterName

指定下列其中一個值：

  • Null 終止的 Unicode 字串指標，其中包含叢集的名稱，或其中一個以 NetBIOS 名稱表示的叢集 節點 、完整 DNS 名稱或 IP 位址。 這會產生 RPC 叢集句柄。
  • NULL，其會產生本機計算機所屬叢集的 LPC 句柄。

[in] DesiredAccess

要求的存取許可權。 這可能是 GENERIC_READ (0x80000000) 、 GENERIC_ALL (0x10000000) 或 MAXIMUM_ALLOWED (0x02000000) 的組合。 如果此值為零 (0) ，則可能會傳回未定義的錯誤。 使用 GENERIC_ALL 與呼叫 OpenCluster 相同。

[out, optional] GrantedAccess

選擇性參數，其中包含將接收授與訪問許可權的 DWORD 位址。 如果 DesiredAccess 參數 MAXIMUM_ALLOWED (0x02000000) ，則此參數所指向的 DWORD 將包含授與此使用者的最大許可權。

傳回值

如果作業成功， OpenClusterEx 會傳回叢集句柄。

傳回碼/值 Description
NULL
0
 作業未成功。 如需錯誤的詳細資訊，請呼叫 GetLastError 函式。 如果目標伺服器不支援 OpenClusterEx 函式 (例如，如果目標伺服器執行 Windows Server 2008 或更早版本) ， 則 GetLastError 函式會傳回 RPC_S_PROCNUM_OUT_OF_RANGE (1745) 。

備註

叢集句柄是內部定義的結構的指標，可儲存與叢集之 RPC 或 LPC 連線的相關信息。 從叢集句柄取得的任何物件句柄都會與儲存在叢集結構中的 RPC 或 LPC 會話數據相關聯。 結合 RPC 和 LPC 句柄或使用從不同內容取得的句柄可能會導致例外狀況或其他無法預期的結果。 如需詳細資訊，請參閱 LPC 和 RPC 句柄。

使用叢集句柄完成時，請務必呼叫 CloseCluster ，以確保釋放所有記憶體，並完全關閉連線。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008 R2 Datacenter、Windows Server 2008 R2 Enterprise
目標平台 Windows
標頭 clusapi.h
程式庫 ClusAPI.lib
Dll ClusAPI.dll