RESOURCE_STATUS 構造体 (resapi.h)
オンラインまたはオフラインになっている リソース に関する情報が含まれます。 この構造体は、コールバック関数 SetResourceStatus のパラメーターとして使用されます。
構文
typedef struct RESOURCE_STATUS {
CLUSTER_RESOURCE_STATE ResourceState;
DWORD CheckPoint;
DWORD WaitHint;
HANDLE EventHandle;
} RESOURCE_STATUS, *PRESOURCE_STATUS;
メンバー
ResourceState
CLUSTER_RESOURCE_STATE列挙によって列挙されたリソースの状態を表す値。 このメンバーに使用できる値は次のとおりです。
ClusterResourceStateUnknown (-1)
状態の取得中にエラーが発生しました。通常は、サーバーが使用できなくなったためです。 詳細については、呼び出し元は関数 GetLastError を呼び出す必要があります。
ClusterResourceOnline (2)
リソースはオンラインで使用できます。
ClusterResourceOffline (3)
リソースはオフラインで使用できません。
ClusterResourceFailed (4)
リソースが失敗しました。
ClusterResourceOnlinePending (129)
リソースはオンラインで配置中です。 CheckPoint メンバーは、このメンバーの前の値より大きくする必要があります。
ClusterResourceOfflinePending (130)
リソースはオフラインの処理中です。
CheckPoint
状態レポートに新しいフラグを設定するために リソース DLL によって設定される値。
WaitHint
このメンバーは、現時点では使用されていません。
EventHandle
リソースがいつ失敗したかを示すイベントを処理します。
注釈
リソース DLL は通常、 ResourceState メンバーを ClusterResourceOnline または ClusterResourceOffline に設定します。 ただし、 ResourceState が ClusterResourceOnlinePending または ClusterResourceOfflinePending に設定されている場合、 CheckPoint メンバーは CheckPoint に対して報告された以前の値より大きくする必要があります。
リソース DLL は最初に CheckPoint を 0 に設定し、 SetResourceStatus の呼び出しごとに 1 ずつインクリメントします。 リソース モニターは、CheckPoint の現在の値を前の値と比較することで、新しい状態レポートを検出します。 値が変更された場合、リソース モニターは新しい状態情報を読み取ります。
ResourceState メンバーで ClusterResourceUnknown 状態を返す前に、リソース DLL で関数 SetLastError を呼び出す必要があります。
リソース DLL は、 EventHandle メンバーを、リソースが失敗したときに通知されるハンドルに設定します。
詳細については、「 リソース DLL の実装」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| Header | resapi.h |