クラスターへの接続を開き、それに対するハンドルを返 します 。
構文
HCLUSTER OpenCluster(
[in, optional] LPCWSTR lpszClusterName
);
パラメーター
[in, optional] lpszClusterName
次のいずれかの値を指定します。
- クラスターの名前、または NetBIOS 名、完全修飾 DNS 名、または IP アドレスとして表されるクラスター ノード の 1 つを含む null で終わる Unicode 文字列へのポインター。 これにより、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 |
| Library | ClusAPI.lib |
| [DLL] | ClusAPI.dll |