ClusterOpenEnum-Funktion (clusapi.h)

Artikel
08/22/2023

Öffnet einen Enumerator zum Durchlaufen von Clusterobjekten in einem Cluster. Der PCLUSAPI_CLUSTER_OPEN_ENUM Typ definiert einen Zeiger auf diese Funktion.

Syntax

HCLUSENUM ClusterOpenEnum(
  [in] HCLUSTER hCluster,
  [in] DWORD    dwType
);

Parameter

[in] hCluster

Ein Handle für einen Cluster.

[in] dwType

Eine Bitmaske, die den Typ der aufzuzählenden Objekte beschreibt. Mindestens einer der folgenden Werte der CLUSTER_ENUM-Enumeration ist gültig.

CLUSTER_ENUM_NODE (1 (0x1))

Listet die Knoten im Cluster auf.

CLUSTER_ENUM_RESTYPE (2 (0x2))

Listet die Ressourcentypen im Cluster auf.

CLUSTER_ENUM_RESOURCE (4 (0x4))

Listet die Ressourcen im Cluster auf.

CLUSTER_ENUM_GROUP (8 (0x8))

Listet die Gruppen im Cluster auf.

CLUSTER_ENUM_NETWORK (16 (0x10))

Listet die Netzwerke im Cluster auf.

CLUSTER_ENUM_NETINTERFACE (32 (0x20))

Listet die Netzwerkschnittstellen im Cluster auf.

CLUSTER_ENUM_SHARED_VOLUME_RESOURCE (1073741824 (0x40000000))

Listet die freigegebenen Clustervolumes auf, die vom Cluster verwendet werden.

Hinweis Im Gegensatz zu den meisten anderen Enumerationsbitmasken muss dieser Wert allein verwendet werden. Verwenden Sie den OR-Operator nicht, um ihn mit anderen Bitmasken zu kombinieren.

Windows Server 2008: Der CLUSTER_ENUM_SHARED_VOLUME_RESOURCE Wert wird vor Windows Server 2008 R2 nicht unterstützt.

CLUSTER_ENUM_INTERNAL_NETWORK (2147483648 (0x80000000))

Listet die Netzwerke auf, die vom Cluster für die interne Kommunikation verwendet werden. Die Netzwerke werden in der Reihenfolge der höchsten bis niedrigsten Priorität aufgelistet, wie von SetClusterNetworkPriorityOrder festgelegt.

Hinweis Im Gegensatz zu den meisten anderen Enumerationsbitmasken muss dieser Wert allein verwendet werden. Verwenden Sie den OR-Operator nicht, um ihn mit anderen Bitmasken zu kombinieren.

CLUSTER_ENUM_ALL ((CLUSTER_ENUM_NODE | CLUSTER_ENUM_RESTYPE | CLUSTER_ENUM_RESOURCE | CLUSTER_ENUM_GROUP | CLUSTER_ENUM_NETWORK | CLUSTER_ENUM_NETINTERFACE))

Listet alle Clusterobjekte auf.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt ClusterOpenEnum ein Handle an einen Clusterenumerator zurück.

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

Anwendungen rufen die ClusterOpenEnum-Funktion auf, um einen bestimmten Enumeratortyp zu erstellen. ClusterOpenEnum kann Enumeratoren zum Durchlaufen von Gruppen, Knoten, Ressourcentypen, Ressourcen oder all diesen Erstellen erstellen. Beispielsweise kann eine Anwendung ClusterOpenEnum aufrufen, um eine Enumeration aller Knoten und Gruppen in einem Cluster abzurufen, indem sie im dwType-Parameter angegeben CLUSTER_ENUM_GROUP | CLUSTER_ENUM_NODE wird. ClusterOpenEnum gibt ein Handle zurück, das an ClusterEnum übergeben werden kann, um auf die einzelnen Clustergruppen oder Knoten zuzugreifen, und an ClusterCloseEnum , um den Enumerator freizugeben.

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

Weitere Informationen

Clusterverwaltungsfunktionen

ClusterCloseEnum

ClusterEnum

SetClusterNetworkPriorityOrder

Freigeben über