ホーム › Networking.Clustering › PCLUSAPI_OPEN_CLUSTER
PCLUSAPI_OPEN_CLUSTER
コールバックシグネチャ
HCLUSTER PCLUSAPI_OPEN_CLUSTER(
LPWSTR lpszClusterName
);パラメーター
| フィールド | 型 | 説明 |
|---|---|---|
| lpszClusterName | LPWSTR | 次のいずれかの値を指定します。
|
公式ドキュメント
クラスターへの接続を開き、そのハンドルを返します。
戻り値
操作が成功した場合、OpenCluster は クラスターハンドルを返します。
| 戻り値/値 | 説明 |
|---|---|
|
操作は成功しませんでした。エラーの詳細については、関数 GetLastError を呼び出してください。 |
解説(Remarks)
クラスターハンドルは、クラスターへの RPC 接続または LPC 接続に関する情報を格納する、内部的に定義された構造体への ポインターです。クラスターハンドルから取得したオブジェクトハンドルはすべて、そのクラスター構造体に格納された RPC セッションデータまたは LPC セッションデータに関連付けられます。RPC ハンドルと LPC ハンドルを混在させたり、異なる コンテキストから取得したハンドルを使用したりすると、例外が発生したり、予測できない結果を招いたりすることがあります。詳細については、 LPC and RPC Handles を参照してください。
クラスターハンドルの使用を終えたら、 CloseCluster を呼び出して、すべてのメモリが解放され、 接続が正常に終了するようにすることが重要です。
クラスターがリモートにある場合、クライアントは互換性のあるオペレーティングシステムを実行している必要があります。たとえば、 Windows Server 2008 を実行しているコンピューターは、Windows Server 2016 を実行しているクラスターに対して OpenCluster を呼び出すことはできません。これらのクラスターをリモートで管理するには、 フェールオーバークラスター WMI プロバイダーを使用してください。
例
Using Object Handles を参照してください。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)