ClusterGroupOpenEnum-Funktion (clusapi.h)

Artikel
08/22/2023

Öffnet einen Enumerator zum Durchlaufen der Ressourcen einer Gruppe und/oder der Knoten, die in der Liste der bevorzugten Besitzer enthalten sind. Der PCLUSAPI_CLUSTER_GROUP_OPEN_ENUM Typ 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 soll.

[in] dwType

Eine Bitmaske, die die aufzuzählenden Clusterobjekte beschreibt. Im Folgenden sind die gültigen Werte der CLUSTER_GROUP_ENUM-Enumeration aufgeführt.

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. Rufen Sie die Funktion GetLastError auf, um weitere Informationen zum Fehler zu erhalten.

Hinweise

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

Beispiele

Weitere Informationen finden Sie unter Auflisten von Objekten.

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