ClusterNodeOpenEnum-Funktion (clusapi.h)

Artikel
02/23/2024

Öffnet einen Enumerator zum Durchlaufen der Netzwerkschnittstellen.
oder auf einem Knoten installierte Gruppen. Der PCLUSAPI_CLUSTER_NODE_OPEN_ENUM Typ definiert einen Zeiger auf diese Funktion.

Syntax

HNODEENUM ClusterNodeOpenEnum(
  [in] HNODE hNode,
  [in] DWORD dwType
);

Parameter

[in] hNode

Handle für einen Knoten.

[in] dwType

Bitmaske, die den Typ der aufzuzählenden Objekte beschreibt. Die folgenden Werte der CLUSTER_NODE_ENUM-Enumeration sind gültig.

CLUSTER_NODE_ENUM_NETINTERFACES (0x00000001)

Auflisten der Netzwerkschnittstellenobjekte auf dem Knoten.

CLUSTER_NODE_ENUM_GROUPS (0x00000002)

Auflisten der Clustergruppen auf dem Knoten.

CLUSTER_NODE_ENUM_ALL ((CLUSTER_NODE_ENUM_NETINTERFACES | CLUSTER_NODE_ENUM_GROUPS))

Auflisten der Netzwerkschnittstellenobjekte und Clustergruppen auf dem Knoten.

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

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt ClusterNodeOpenEnum ein Handle an einen Knotenenumerator zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion NULL zurück. Rufen Sie die GetLastError-Funktion auf, um weitere Informationen zum Fehler zu erhalten.

Hinweise

Die ClusterNodeOpenEnum-Funktion gibt ein Handle zurück, das an ClusterNodeEnum übergeben werden kann, um auf jedes der zu enumerierten Objekte zuzugreifen, und an ClusterNodeCloseEnum , 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