ホーム › Networking.Clustering › PCLUSAPI_GET_CLUSTER_GROUP_STATE

PCLUSAPI_GET_CLUSTER_GROUP_STATE

コールバック

シグネチャ

CLUSTER_GROUP_STATE PCLUSAPI_GET_CLUSTER_GROUP_STATE(
    HGROUP hGroup,
    LPWSTR lpszNodeName,
    DWORD* lpcchNodeName
);

パラメーター

フィールド	型	説明
hGroup	HGROUP	状態情報を取得する対象のグループのハンドルです。
lpszNodeName	LPWSTR	現在このグループを所有しているノードの名前を格納する、null 終端の Unicode 文字列へのポインターです。
lpcchNodeName	DWORD*	lpszNodeName バッファーのサイズ (文字数) へのポインターです。入力時には、終端の NULL を含めてバッファーが保持できる最大文字数を指定します。出力時には、終端の NULL を除いた、取得された名前の文字数が格納されます。

公式ドキュメント

グループの現在の状態を返します。PCLUSAPI_GET_CLUSTER_GROUP_STATE 型は、この関数へのポインターを定義します。

戻り値

GetClusterGroupState は、グループの現在の状態を返します。状態は次のいずれかの値で表されます。

戻り値/値	説明
ClusterGroupStateUnknown -1	操作は成功しませんでした。エラーの詳細については、GetLastError 関数を呼び出してください。
ClusterGroupOnline 0	グループ内のすべてのリソースがオンラインです。
ClusterGroupOffline 1	グループ内のすべてのリソースがオフラインであるか、グループにリソースがありません。
ClusterGroupFailed 2	グループ内の少なくとも 1 つのリソースが失敗しました (CLUSTER_RESOURCE_STATE 列挙型の ClusterResourceFailed 状態が設定されています)。
ClusterGroupPartialOnline 3	グループ内の少なくとも 1 つのリソースがオンラインです。保留中または失敗の状態のリソースはありません。
ClusterGroupPending 4	グループ内の少なくとも 1 つのリソースが保留状態です。失敗した状態のリソースはありません。

解説(Remarks)

lpcchName はバイト数ではなく文字数を表し、返されるサイズには終端の NULL が含まれない点に注意してください。バッファーのサイズ指定の詳細については、Data Size Conventions を参照してください。

GetClusterGroupState をリソース DLL のエントリポイント関数から呼び出さないでください。GetClusterGroupState はワーカースレッドから安全に呼び出すことができます。詳細については、Function Calls to Avoid in Resource DLLs を参照してください。

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