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

PCLUSAPI_OPEN_CLUSTER_EX

コールバック

シグネチャ

HCLUSTER PCLUSAPI_OPEN_CLUSTER_EX(
    LPWSTR lpszClusterName,
    DWORD dwDesiredAccess,
    DWORD* lpdwGrantedAccess
);

パラメーター

フィールド型説明
lpszClusterNameLPWSTR

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

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

公式ドキュメント

<a href="/previous-versions/windows/desktop/mscs/c-gly">クラスター</a> への接続を開き、そのハンドルを返します。

戻り値

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

リターンコード/値 説明
NULL
0
 操作は成功しませんでした。エラーの詳細については、 GetLastError 関数を呼び出してください。対象のサーバーが OpenClusterEx 関数をサポートしていない場合(たとえば対象のサーバーが Windows Server 2008 以前を実行している場合)、 GetLastError 関数は RPC_S_PROCNUM_OUT_OF_RANGE (1745) を返します。

解説(Remarks)

クラスターハンドルは、クラスターへの RPC 接続または LPC 接続に関する情報を保持する、内部で定義された構造体へのポインターです。そのクラスターハンドルから取得したオブジェクトハンドルはすべて、クラスター構造体に格納された RPC セッションデータまたは LPC セッションデータに関連付けられます。RPC ハンドルと LPC ハンドルを混在させたり、異なるコンテキストから取得したハンドルを使用したりすると、例外やその他の予期しない結果が発生する可能性があります。詳細については、 LPC and RPC Handles を参照してください。

クラスターハンドルの使用を終えたら、 CloseCluster を呼び出して、すべてのメモリが解放され、接続が正常にシャットダウンされるようにすることが重要です。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)