Partager via

Fonction ClusterNetInterfaceEnum (clusapi.h)

  • Article

Énumère les interfaces réseau installées sur un cluster, en retournant un nom à chaque appel.

Syntaxe

DWORD ClusterNetInterfaceEnum(
  [in]      HNETINTERFACEENUM hNetInterfaceEnum,
  [in]      DWORD             dwIndex,
  [out]     LPWSTR            lpszName,
  [in, out] LPDWORD           lpcchName
);

Paramètres

[in] hNetInterfaceEnum

Gérez un objet d’énumération existant retourné à l’origine par la fonction ClusterNetInterfaceOpenEnum .

[in] dwIndex

Index utilisé pour identifier l’entrée à énumérer. Ce paramètre doit être égal à zéro pour le premier appel, puis incrémenté pour chaque appel suivant.

[out] lpszName

Pointeur vers une chaîne Unicode terminée par null contenant le nom de l’objet retourné.

[in, out] lpcchName

Pointeur vers la taille, en caractères, de la mémoire tampon lpszName . Lors de l’entrée, spécifiez le nombre maximal de caractères que la mémoire tampon peut contenir, y compris la valeur NULL de fin. Sur la sortie, indique le nombre de caractères dans le nom résultant, à l’exclusion de la valeur NULL de fin.

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 avec succès.
ERROR_NO_MORE_ITEMS
259 (0x103)
 Aucune donnée n'est disponible. Cette valeur est retournée s’il n’y a plus d’objets à retourner.
ERROR_MORE_DATA
234 (0xEA)
 More data is available. Cette valeur est retournée si la mémoire tampon pointée vers 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 de la valeur NULL de fin.

Configuration requise

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