ClusterEnumEx-Funktion (clusapi.h)

Artikel
02/26/2024

Listet die Objekte in einem Cluster auf und ruft dann den Namen und die Eigenschaften des Clusterobjekts ab.

Syntax

DWORD ClusterEnumEx(
  [in]      HCLUSENUMEX        hClusterEnum,
  [in]      DWORD              dwIndex,
  [in, out] PCLUSTER_ENUM_ITEM pItem,
  [in, out] LPDWORD            cbItem
);

Parameter

[in] hClusterEnum

Ein Handle für den Enumerator, der von der ClusterOpenEnumEx-Funktion zurückgegeben wird.

[in] dwIndex

Der Index, der das nächste Clusterobjekt identifiziert, das aufgelistet werden soll. Dieser Parameter sollte für den ersten Aufruf der ClusterEnumEx-Funktion null sein und dann für nachfolgende Aufrufe inkrementiert werden.

[in, out] pItem

Ein Zeiger, der die zurückgegebenen Clusterobjekteigenschaften empfängt.

[in, out] cbItem

Bei der Eingabe die Größe des pItem-Parameters .

Bei der Ausgabe entweder die erforderliche Größe in Bytes des Puffers, wenn der Puffer zu klein ist, oder die Anzahl der Bytes, die in den Puffer geschrieben werden.

Rückgabewert

Rückgabecode	Beschreibung
ERROR_NO_MORE_ITEMS	Der dwIndex-Parameter ist größer als die Anzahl der Elemente in der Enumeration.
ERROR_MORE_DATA	Der Puffer ist zu klein.
ERROR_SUCCESS	Der Puffer wurde erfolgreich gefüllt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 Datacenter, Windows Server 2008 R2 Enterprise
Zielplattform	Windows
Kopfzeile	clusapi.h
Bibliothek	ClusAPI.lib
DLL	ClusAPI.dll

Weitere Informationen

CLUSTER_ENUM_ITEM

Failoverclusterverwaltungsfunktion

Freigeben über