GetClusterInformation 関数 (clusapi.h)

クラスターの名前とバージョン を取得します 。 PCLUSAPI_GET_CLUSTER_INFORMATION型は、この関数へのポインターを定義します。

構文

DWORD GetClusterInformation(
  [in]            HCLUSTER             hCluster,
  [out]           LPWSTR               lpszClusterName,
  [in, out]       LPDWORD              lpcchClusterName,
  [out, optional] LPCLUSTERVERSIONINFO lpClusterInfo
);

パラメーター

[in] hCluster

クラスターへの処理。

[out] lpszClusterName

hCluster によって識別されるクラスターの名前を含む null で終わる Unicode 文字列へのポインター。

[in, out] lpcchClusterName

lpszClusterName バッファーのサイズを文字数として指すポインター。 入力時に、バッファーが保持できる最大文字数 (終端の NULL を含む) を指定 します。 出力時に、終了する NULL を除く、結果の名前の文字数を指定 します。

[out, optional] lpClusterInfo

NULL またはクラスター サービスのバージョンを記述する CLUSTERVERSIONINFO 構造体へのポインター。 lpClusterInfo が NULL でない場合、この構造体の dwVersionInfoSize メンバーは次のように設定する必要があります。lpClusterInfo->dwVersionInfoSize = sizeof(CLUSTERVERSIONINFO);

戻り値

操作が成功すると、関数は ERROR_SUCCESS (0) を返します。

操作が失敗した場合、関数は システム エラー コードを返します。 使用可能な値の 1 つを次に示します。

リターン コード 説明
ERROR_MORE_DATA
 lpszClusterName が指すバッファーは、結果を保持するのに十分な大きさではありません。 lpcchClusterName パラメーターは、終了する NULL を除き、結果の文字数を返します。

注釈

lpcchClusterName はバイト数ではなく文字数を参照し、返されるサイズにはカウントに終端の NULL が含まれていないことに注意してください。 バッファーのサイズ設定の詳細については、「 データ サイズ規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
対象プラットフォーム Windows
ヘッダー clusapi.h
Library ClusAPI.lib
[DLL] ClusAPI.dll

こちらもご覧ください

CLUSTERVERSIONINFO

  • 最終更新: