Fonction ClusterEnumEx (clusapi.h)

Article
02/26/2024

Énumère les objets dans un cluster, puis obtient le nom et les propriétés de l’objet de cluster.

Syntaxe

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

Paramètres

[in] hClusterEnum

Handle de l’énumérateur retourné par la fonction ClusterOpenEnumEx .

[in] dwIndex

Index qui identifie l’objet de cluster suivant à énumérer. Ce paramètre doit être égal à zéro pour le premier appel à la fonction ClusterEnumEx , puis être incrémenté pour les appels suivants.

[in, out] pItem

Pointeur qui reçoit les propriétés de l’objet de cluster retournées.

[in, out] cbItem

Lors de l’entrée, la taille du paramètre 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	Le paramètre dwIndex est supérieur au nombre d’éléments dans 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.

Configuration requise

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

Voir aussi

CLUSTER_ENUM_ITEM

Fonction de gestion du cluster de basculement

Partager via