RESOURCE_STATUS-Struktur (resapi.h)
Enthält Informationen zu einer Ressource , die online geschaltet oder offline geschaltet wird. Diese Struktur wird als Parameter für die Rückruffunktion SetResourceStatus verwendet.
Syntax
typedef struct RESOURCE_STATUS {
CLUSTER_RESOURCE_STATE ResourceState;
DWORD CheckPoint;
DWORD WaitHint;
HANDLE EventHandle;
} RESOURCE_STATUS, *PRESOURCE_STATUS;
Member
ResourceState
Ein Wert, der den Zustand einer Ressource beschreibt, die von der CLUSTER_RESOURCE_STATE-Enumeration aufgezählt wird. Die möglichen Werte für diesen Member sind wie folgt:
ClusterResourceStateUnknown (-1)
Beim Abrufen des Zustands ist ein Fehler aufgetreten, in der Regel, weil der Server nicht mehr verfügbar ist. Für weitere Informationen sollte der Aufrufer die Funktion GetLastError aufrufen.
ClusterResourceOnline (2)
Die Ressource ist online und verfügbar.
ClusterResourceOffline (3)
Die Ressource ist offline und nicht verfügbar.
ClusterResourceFailed (4)
Bei der Ressource ist ein Fehler aufgetreten.
ClusterResourceOnlinePending (129)
Die Ressource wird gerade online gestellt. Der CheckPoint-Member sollte größer als der vorherige Wert dieses Elements sein.
ClusterResourceOfflinePending (130)
Die Ressource wird gerade offline geschaltet.
CheckPoint
Ein von der Ressourcen-DLL festgelegter Wert, um einen status Bericht als neu zu kennzeichnen.
WaitHint
Dieses Element wird zurzeit nicht verwendet.
EventHandle
Behandeln Sie ein Ereignis, das angibt, wenn die Ressource ausgefallen ist.
Hinweise
Ressourcen-DLLs legen den ResourceState-Member in der Regel auf ClusterResourceOnline oder ClusterResourceOffline fest. Wenn ResourceState jedoch auf ClusterResourceOnlinePending oder ClusterResourceOfflinePending festgelegt ist, sollte das CheckPoint-Element größer als der vorherige für CheckPoint gemeldete Wert sein.
Ressourcen-DLLs legen CheckPoint zunächst auf Null fest und erhöhen sie dann um 1 für jeden Aufruf von SetResourceStatus. Ressourcenmonitore erkennen neue status Berichte, indem sie den aktuellen Wert von CheckPoint mit dem vorherigen Wert vergleichen. Wenn sich der Wert geändert hat, liest der Ressourcenmonitor die neuen status Informationen.
Bevor Sie den Status ClusterResourceUnknown im ResourceState-Member zurückgeben, sollte eine Ressourcen-DLL die Funktion SetLastError aufrufen.
Ressourcen-DLLs legen das EventHandle-Element auf ein Handle fest, das signalisiert wird, wenn eine Ressource ausfällt.
Weitere Informationen finden Sie unter Implementieren von Ressourcen-DLLs.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Kopfzeile | resapi.h |