Fonction ClusterGroupEnumEx (clusapi.h)

Article
02/23/2024

Récupère un élément de l’énumération. Le type PCLUSAPI_CLUSTER_GROUP_ENUM_EX définit un pointeur vers cette fonction.

Syntaxe

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

Paramètres

[in] hGroupEnumEx

Handle de l’énumération à partir de laquelle l’élément sera récupéré.

[in] dwIndex

Index de base zéro de l’élément dans l’énumération.

[in, out] pItem

Pointeur vers la mémoire tampon à remplir.

[in, out] cbItem

En entrée, la taille de pItem.

En sortie, soit la taille requise en octets de la mémoire tampon si la mémoire tampon est trop petite, soit le nombre d’octets écrits dans la mémoire tampon.

Valeur retournée

Code de retour	Description
ERROR_NO_MORE_ITEMS	dwIndex est supérieur au nombre d’éléments de l’énumération.
ERROR_MORE_DATA	La mémoire tampon est trop petite.
ERROR_SUCCESS	La mémoire tampon a été remplie avec succès.

Remarques

La fonction ClusterGroupEnumEx ne se connecte pas au cluster, car le hGroupEnumEx contient déjà les données d’énumération. Les données sont copiées dans la mémoire tampon, mais aucune donnée n’est récupérée à partir du cluster.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	clusapi.h
Bibliothèque	ClusAPI.lib
DLL	ClusAPI.dll

Partager via