ClusterGroupEnumEx-Funktion (clusapi.h)

Artikel
02/26/2024

Ruft ein Element in der -Enumeration ab. Der PCLUSAPI_CLUSTER_GROUP_ENUM_EX Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ClusterGroupEnumEx(
  [in]      HGROUPENUMEX             hGroupEnumEx,
  [in]      DWORD                    dwIndex,
  [in, out] PCLUSTER_GROUP_ENUM_ITEM pItem,
  [in, out] LPDWORD                  cbItem
);

Parameter

[in] hGroupEnumEx

Das Handle für die Enumeration, aus der das Element abgerufen wird.

[in] dwIndex

Der nullbasierte Index des Elements in der Enumeration.

[in, out] pItem

Ein Zeiger auf den zu füllenden Puffer.

[in, out] cbItem

Bei der Eingabe die Größe von pItem.

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

Rückgabewert

Rückgabecode	Beschreibung
ERROR_NO_MORE_ITEMS	dwIndex 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.

Hinweise

Die ClusterGroupEnumEx-Funktion stellt keine Verbindung mit dem Cluster her, da hGroupEnumEx die Enumerationsdaten bereits enthält. Die Daten werden in den Puffer kopiert, aber es werden keine Daten aus dem Cluster abgerufen.

Anforderungen

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

Freigeben über