OpenCluster 函式 (clusapi.h)
開啟 叢集 的連線，並傳回它的句柄。
語法
HCLUSTER OpenCluster(
[in, optional] LPCWSTR lpszClusterName
);
參數
[in, optional] lpszClusterName
指定下列其中一個值：
- Null 終止的 Unicode 字串指標，其中包含叢集的名稱，或其中一個以 NetBIOS 名稱表示的叢集 節點 、完整 DNS 名稱或 IP 位址。 這會產生 RPC 叢集句柄。
- NULL，其會產生本機計算機所屬叢集的 LPC 句柄。
傳回值
如果作業成功， OpenCluster 會傳回叢集句柄。
| 傳回碼/值 | Description |
|---|---|
|
作業未成功。 如需錯誤的詳細資訊，請呼叫 函式 GetLastError。 |
備註
叢集句柄是內部定義的結構的指標，可儲存與叢集之 RPC 或 LPC 連線的相關信息。 從叢集句柄取得的任何物件句柄都會與儲存在叢集結構中的 RPC 或 LPC 會話數據相關聯。 結合 RPC 和 LPC 句柄或使用從不同內容取得的句柄可能會導致例外狀況或其他無法預期的結果。 如需詳細資訊，請參閱 LPC 和 RPC 句柄。
使用叢集句柄完成時，請務必呼叫 CloseCluster ，以確保釋放所有記憶體，並完全關閉連線。
如果叢集是遠端的，客戶端必須執行相容的作業系統。 例如，執行 Windows Server 2008 的電腦無法針對執行 Windows Server 2016 的叢集呼叫 OpenCluster。 若要從遠端管理這些叢集，請使用 故障轉移叢集 WMI 提供者。
範例
請參閱 使用物件句柄。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 目標平台 | Windows |
| 標頭 | clusapi.h |
| 程式庫 | ClusAPI.lib |
| Dll | ClusAPI.dll |