GetClusterGroupState 関数 (clusapi.h)
グループの現在の状態を返 します。 PCLUSAPI_GET_CLUSTER_GROUP_STATE型は、この関数へのポインターを定義します。
構文
CLUSTER_GROUP_STATE GetClusterGroupState(
[in] HGROUP hGroup,
[out, optional] LPWSTR lpszNodeName,
[in, out, optional] LPDWORD lpcchNodeName
);
パラメーター
[in] hGroup
状態情報を返す必要があるグループを処理します。
[out, optional] lpszNodeName
現在グループを所有しているノードの名前を含む null で終わる Unicode 文字列へのポインター。
[in, out, optional] lpcchNodeName
文字数としての lpszNodeName バッファーのサイズへのポインター。 入力時に、バッファーが保持できる最大文字数 (終端の NULL を含む) を指定 します。 出力時に、終了する NULL を除く、結果の名前の文字数を指定します。
戻り値
GetClusterGroupState は、次のいずれかの値で表されるグループの現在の状態を返します。
| リターン コード/値 | Description |
|---|---|
|
操作が成功しなかった。 エラーの詳細については、 GetLastError 関数を呼び出します。 |
|
グループ内のすべてのリソースは オンラインです。 |
|
グループ内のすべてのリソースが オフライン であるか、グループ内にリソースがありません。 |
|
グループ内の少なくとも 1 つのリソースが失敗しました (CLUSTER_RESOURCE_STATE列挙から ClusterResourceFailed の状態を設定します)。 |
|
グループ内の少なくとも 1 つのリソースがオンラインです。 保留中または失敗したリソースはありません。 |
|
グループ内の少なくとも 1 つのリソースが保留中です。 エラーのリソースはありません。 |
注釈
lpcchName はバイト数ではなく文字数を参照し、返されるサイズにはカウントに終端の NULL が含まれていないことに注意してください。 バッファーのサイズ設定の詳細については、「 データ サイズ規則」を参照してください。
リソース DLL エントリ ポイント関数から GetClusterGroupState を 呼び出さないでください。 GetClusterGroupState は、ワーカー スレッドから安全に呼び出すことができます。 詳細については、「 リソース DLL での回避する関数呼び出し」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | clusapi.h |
| Library | ClusAPI.lib |
| [DLL] | ClusAPI.dll |