GetClusterResourceState-Funktion (clusapi.h)

Artikel
08/22/2023

Gibt den aktuellen Zustand einer Ressource zurück. Der PCLUSAPI_GET_CLUSTER_RESOURCE_STATE Typ definiert einen Zeiger auf diese Funktion.

Syntax

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
);

Parameter

[in] hResource

Handle zum Angeben der Ressource, für die Zustandsinformationen zurückgegeben werden sollen.

[out, optional] lpszNodeName

Zeiger auf einen Puffer, der den Namen des aktuellen Besitzerknotens der angegebenen Ressource als MIT NULL beendete Unicode-Zeichenfolge empfängt. Übergeben Sie NULL , wenn der Knotenname nicht erforderlich ist.

[in, out, optional] lpcchNodeName

Zeiger auf die Größe des lpszNodeName-Puffers als Anzahl von Zeichen. Dieser Zeiger darf nicht NULL sein, es sei denn , lpszNodeName ist ebenfalls NULL. Gibt bei der Eingabe die maximale Anzahl von Zeichen an, die der Puffer enthalten kann, einschließlich des beendenden NULL. Gibt bei der Ausgabe die Anzahl der Zeichen im resultierenden Namen an, wobei der abschließende NULL-Wert ausgeschlossen wird.

[out, optional] lpszGroupName

Zeiger auf einen Puffer, der den Namen der Gruppe empfängt, die die angegebene Ressource enthält. Der Name wird als MIT NULL endende Unicode-Zeichenfolge zurückgegeben. Übergeben Sie NULL , wenn der Gruppenname nicht erforderlich ist.

[in, out, optional] lpcchGroupName

Zeiger auf die Größe des puffers lpszGroupName als Anzahl von Zeichen. Dieser Zeiger darf nicht NULL sein, es sei denn , lpszNodeName ist ebenfalls NULL. Gibt bei der Eingabe die maximale Anzahl von Zeichen an, die der Puffer enthalten kann, einschließlich des beendenden NULL. Gibt bei der Ausgabe die Anzahl der Zeichen im resultierenden Namen an, wobei der abschließende NULL-Wert ausgeschlossen wird.

Rückgabewert

GetClusterResourceState gibt den aktuellen Zustand der Ressource zurück, die aus der CLUSTER_RESOURCE_STATE Enumeration aufgezählt wurde, die durch einen der folgenden Werte dargestellt werden kann.

Rückgabecode/-wert	BESCHREIBUNG
ClusterResourceInitializing 1	Die Ressource führt die Initialisierung durch.
ClusterResourceOnline 2	Die Ressource ist betriebsbereit und funktioniert normal.
ClusterResourceOffline 3	Die Ressource ist nicht betriebsbereit. Dieser Wert wird zurückgegeben, wenn die Ressource den Status ClusterResourceOffline (3) oder ClusterResourceCannotComeOnlineOnThisNode (127) gemeldet hat.
ClusterResourceFailed 4	Bei der Ressource ist ein Fehler aufgetreten. Dieser Wert wird zurückgegeben, wenn die Ressource den Status ClusterResourceFailed (4) oder ClusterResourceCannotComeOnlineOnAnyNode (126) gemeldet hat.
ClusterResourcePending 128	Die Ressource wird gerade online oder offline geschaltet.
ClusterResourceOnlinePending 129	Die Ressource wird gerade online geschaltet.
ClusterResourceOfflinePending 130	Die Ressource wird gerade offline geschaltet.
ClusterResourceStateUnknown -1	Der Vorgang war nicht erfolgreich. Rufen Sie die Funktion GetLastError auf, um weitere Informationen zum Fehler zu erhalten.

Hinweise

Rufen Sie GetClusterResourceState nicht über eine Ressourcen-DLL-Einstiegspunktfunktion auf. GetClusterResourceState kann sicher von einem Workerthread aufgerufen werden. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.

Beispiele

Ein Beispiel finden Sie unter Abrufen von Objektzuständen .

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Windows
Kopfzeile	clusapi.h
Bibliothek	ClusAPI.lib
DLL	ClusAPI.dll