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 つを次に示します。
リターン コード | 説明 |
---|---|
|
lpszClusterName が指すバッファーは、結果を保持するのに十分な大きさではありません。 lpcchClusterName パラメーターは、終了する NULL を除き、結果の文字数を返します。 |
注釈
lpcchClusterName はバイト数ではなく文字数を参照し、返されるサイズにはカウントに終端の NULL が含まれていないことに注意してください。 バッファーのサイズ設定の詳細については、「 データ サイズ規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | サポートなし |
サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
対象プラットフォーム | Windows |
ヘッダー | clusapi.h |
Library | ClusAPI.lib |
[DLL] | ClusAPI.dll |