Fonction ClusterResourceEnumEx (clusapi.h)

Article
08/22/2023

Énumère une ressource, puis retourne un pointeur vers la ressource ou le nœud dépendant actuel.

Syntaxe

DWORD ClusterResourceEnumEx(
  [in]      HRESENUMEX                  hResourceEnumEx,
  [in]      DWORD                       dwIndex,
  [in, out] PCLUSTER_RESOURCE_ENUM_ITEM pItem,
  [in, out] LPDWORD                     cbItem
);

Paramètres

[in] hResourceEnumEx

Handle d’une énumération de ressource retournée à partir de la fonction ClusterResourceOpenEnumEx .

[in] dwIndex

Index de la ressource ou de l’objet de nœud à retourner. Ce paramètre doit être égal à zéro pour le premier appel à la fonction ClusterResourceEnumEx , puis être
incrémenté pour les appels suivants.

[in, out] pItem

Pointeur qui reçoit l’objet retourné.

[in, out] cbItem

En entrée, 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

La fonction retourne l’une des valeurs suivantes.

Code/valeur de retour	Description
ERROR_SUCCESS 0	L’opération s’est terminée correctement ou le paramètre lpszName a la valeur NULL.
ERROR_MORE_DATA 234 (0xEA)	La mémoire tampon vers laquelle pointe le paramètre lpszName n’est pas assez grande pour contenir le résultat. Le paramètre lpcchName retourne le nombre de caractères dans le résultat, à l’exclusion du caractère null de fin.
ERROR_NO_MORE_ITEMS 259 (0x103)	Il n’y a plus d’objets à retourner.
Code d’erreur système	Tout autre code d’erreur retourné indique que l’opération a échoué.

Configuration requise


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

Voir aussi

ClusterResourceOpenEnumEx

Fonctions de gestion des ressources du cluster de basculement

Partager via