Win32 API 日本語リファレンス
ホーム › Networking.Clustering › PCLUSAPI_OPEN_CLUSTER

PCLUSAPI_OPEN_CLUSTER

コールバック

シグネチャ

HCLUSTER PCLUSAPI_OPEN_CLUSTER(
    LPWSTR lpszClusterName
);

パラメーター

フィールド型説明
lpszClusterNameLPWSTR

次のいずれかの値を指定します。

  • クラスター名、またはクラスターの ノードのいずれかを、NetBIOS 名、完全修飾 DNS 名、または IP アドレスで表した、null で終わる Unicode 文字列へのポインター。これにより RPC クラスターハンドルが生成されます。
  • NULL。これにより、ローカルコンピューターが所属するクラスターへの LPC ハンドルが 生成されます。

公式ドキュメント

クラスターへの接続を開き、そのハンドルを返します。

戻り値

操作が成功した場合、OpenCluster は クラスターハンドルを返します。

戻り値/値 説明
NULL
0
操作は成功しませんでした。エラーの詳細については、関数 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)