GetClusterGroupState-Funktion (clusapi.h)

Artikel
08/22/2023

Gibt den aktuellen Status einer Gruppe zurück. Der PCLUSAPI_GET_CLUSTER_GROUP_STATE-Typs definiert einen Zeiger auf diese Funktion.

Syntax

CLUSTER_GROUP_STATE GetClusterGroupState(
  [in]                HGROUP  hGroup,
  [out, optional]     LPWSTR  lpszNodeName,
  [in, out, optional] LPDWORD lpcchNodeName
);

Parameter

[in] hGroup

Handle an die Gruppe, für die Zustandsinformationen zurückgegeben werden sollen.

[out, optional] lpszNodeName

Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen des Knotens enthält, der derzeit besitzer der Gruppe ist.

[in, out, optional] lpcchNodeName

Zeiger auf die Größe des Puffers lpszNodeName als Anzahl von Zeichen. Geben Sie 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 beendende NULL-Wert ausgeschlossen wird.

Rückgabewert

GetClusterGroupState gibt den aktuellen Status der Gruppe zurück, der durch einen der folgenden Werte dargestellt wird.

Rückgabecode/-wert	BESCHREIBUNG
ClusterGroupStateUnknown -1	Der Vorgang war nicht erfolgreich. Rufen Sie die Funktion GetLastError auf, um weitere Informationen zum Fehler zu erhalten.
ClusterGroupOnline 0	Alle Ressourcen in der Gruppe sind online.
ClusterGroupOffline 1	Alle Ressourcen in der Gruppe sind offline , oder es sind keine Ressourcen in der Gruppe vorhanden.
ClusterGroupFailed 2	Mindestens eine Ressource in der Gruppe ist fehlgeschlagen (legen Sie den Status ClusterResourceFailed aus der CLUSTER_RESOURCE_STATE-Enumeration fest).
ClusterGroupPartialOnline 3	Mindestens eine Ressource der Gruppe ist online. Es sind keine Ressourcen ausstehend oder fehlgeschlagen.
ClusterGroupPending 4	Mindestens eine Ressource der Gruppe steht noch aus. Es sind keine Ressourcenfehler aufgetreten.

Hinweise

Beachten Sie, dass lpcchName auf eine Anzahl von Zeichen und nicht auf die Anzahl von Bytes verweist, und dass die zurückgegebene Größe nicht den beendenden NULL in der Anzahl enthält. Weitere Informationen zur Größenanpassung von Puffern finden Sie unter Datengrößenkonventionen.

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

Anforderungen

Anforderung	Wert
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

Weitere Informationen

CLUSTER_GROUP_STATE

CLUSTER_RESOURCE_STATE

Gruppenverwaltungsfunktionen

OpenClusterGroup

Freigeben über