GetClusterResourceState 関数 (clusapi.h)
リソースの現在の状態を返 します。 PCLUSAPI_GET_CLUSTER_RESOURCE_STATE型は、この関数へのポインターを定義します。
構文
CLUSTER_RESOURCE_STATE GetClusterResourceState(
[in] HRESOURCE hResource,
[out, optional] LPWSTR lpszNodeName,
[in, out, optional] LPDWORD lpcchNodeName,
[out, optional] LPWSTR lpszGroupName,
[in, out, optional] LPDWORD lpcchGroupName
);
パラメーター
[in] hResource
状態情報を返すリソースを指定する処理。
[out, optional] lpszNodeName
指定したリソースの現在の所有者ノードの名前を NULL で終わる Unicode 文字列として受け取るバッファーへのポインター。 ノード名が不要な場合は NULL を 渡します。
[in, out, optional] lpcchNodeName
文字数としての lpszNodeName バッファーのサイズへのポインター。 lpszNodeNameも NULL でない限り、このポインターを NULL にすることはできません。 入力時に、バッファーが保持できる最大文字数 (終端の NULL を含む) を指定します。 出力時に、終了する NULL を除く、結果の名前の文字数を指定します。
[out, optional] lpszGroupName
指定したリソースを含む グループ の名前を受け取るバッファーへのポインター。 名前は NULL で終わる Unicode 文字列として返されます。 グループ名が不要な場合は NULL を 渡します。
[in, out, optional] lpcchGroupName
文字数としての lpszGroupName バッファーのサイズへのポインター。 lpszNodeNameも NULL でない限り、このポインターを NULL にすることはできません。 入力時に、バッファーが保持できる最大文字数 (終端の NULL を含む) を指定します。 出力時に、終了する NULL を除く、結果の名前の文字数を指定します。
戻り値
GetClusterResourceState は、 CLUSTER_RESOURCE_STATE 列挙から列挙されたリソースの現在の状態を返します。これは、次のいずれかの値で表すことができます。
| リターン コード/値 | Description |
|---|---|
|
リソースは初期化を実行しています。 |
|
リソースは正常に動作し、正常に機能しています。 |
|
リソースが動作していません。 この値は、リソースが ClusterResourceOffline (3) または ClusterResourceCannotComeOnlineOnThisNode (127) の状態を報告した場合に返されます。 |
|
リソースが失敗しました。 この値は、リソースが ClusterResourceFailed (4) または ClusterResourceCannotComeOnlineOnAnyNode (126) の状態を報告した場合に返されます。 |
|
リソースは、オンラインまたはオフラインになる処理中です。 |
|
リソースはオンラインになる過程にあります。 |
|
リソースはオフラインの処理中です。 |
|
操作が成功しなかった。 エラーの詳細については、 GetLastError 関数を呼び出します。 |
解説
リソース DLL エントリ ポイント関数から GetClusterResourceState を 呼び出さないでください。 GetClusterResourceState は、ワーカー スレッドから安全に呼び出すことができます。 詳細については、「 リソース DLL での回避する関数呼び出し」を参照してください。
例
例については、「 オブジェクトの状態の取得 」を参照してください。
要件
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | clusapi.h |
| Library | ClusAPI.lib |
| [DLL] | ClusAPI.dll |