ClusterGroupOpenEnum-Funktion (clusapi.h)

Artikel
07/16/2024

Öffnet einen Enumerator zum Durchlaufen derRessourcen einer Gruppe und/oder der Knoten, die in der Liste der bevorzugten Besitzer enthalten sind. Der typ PCLUSAPI_CLUSTER_GROUP_OPEN_ENUM definiert einen Zeiger auf diese Funktion.

Syntax

HGROUPENUM ClusterGroupOpenEnum(
  [in] HGROUP hGroup,
  [in] DWORD  dwType
);

Parameter

[in] hGroup

Ein Handle für die -Gruppe, die aufgezählt werden sollen.

[in] dwType

Eine Bitmaske, die die Clusterobjekte beschreibt, aufgezählt werden sollen. Es folgen gültige Werte der CLUSTER_GROUP_ENUM-Aufzählung.

CLUSTER_GROUP_ENUM_CONTAINS (1)

Listet die Ressourcen in der Gruppe auf.

CLUSTER_GROUP_ENUM_NODES (2)

Listet die Knoten in der Liste der bevorzugten Besitzer der Gruppe auf.

CLUSTER_GROUP_ENUM_ALL (3)

Listet die Ressourcen in der Gruppe und die bevorzugten Besitzer der Gruppe auf.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt ClusterGroupOpenEnum ein Handle an einen Enumerator zurück, der an die ClusterGroupEnum--Funktion übergeben werden kann.

Wenn der Vorgang fehlschlägt, gibt die Funktion NULL-zurück. Um weitere Informationen zum Fehler zu erhalten, rufen Sie die Funktion GetLastErrorauf.

Bemerkungen

Rufen Sie ClusterGroupOpenEnum- von einer Ressourcen-DLL-Einstiegspunktfunktion nicht auf. ClusterGroupOpenEnum- kann sicher über einen Arbeitsthread aufgerufen werden. Weitere Informationen finden Sie unter Funktionsaufrufe zur Vermeidung in Ressourcen-DLLs.

Beispiele

Siehe Aufzählen von Objekten.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Keine unterstützt
mindestens unterstützte Server-	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform-	Fenster
Header-	clusapi.h
Library	ClusAPI.lib
DLL-	ClusAPI.dll