Auf Englisch lesen

Freigeben über


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

Weitere Informationen

CLUSTER_RESOURCE_STATE

Ressourcen-DLL-Strukturen

SetResourceStatus