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 設定為零，然後針對 SetResourceStatus 的每個呼叫將它遞增 1。 資源監視器會 藉由比較 CheckPoint 的目前值與先前的值來偵測新的狀態報告。 如果值已變更，資源監視器會讀取新的狀態資訊。
在傳回 ResourceState 成員中的 ClusterResourceUnknown 狀態之前，資源 DLL 應該呼叫 SetLastError 函式。
資源 DLL 會將 EventHandle 成員設定為資源失敗時發出訊號的句柄。
如需詳細資訊，請參閱 實作資源 DLL。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 標頭 | resapi.h |