GetIfTable2, fonction (netioapi.h)

Article
02/29/2024

La fonction GetIfTable2 récupère la table d’interface MIB-II.

Syntaxe

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfTable2(
  [out] PMIB_IF_TABLE2 *Table
);

Paramètres

[out] Table

Pointeur vers une mémoire tampon qui reçoit la table des interfaces dans une structure MIB_IF_TABLE2 .

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_NOT_ENOUGH_MEMORY	Les ressources de mémoire sont insuffisantes pour terminer l’opération.
Autres	Utilisez FormatMessage pour obtenir la chaîne de message de l’erreur retournée.

Remarques

The
La fonction GetIfTable2 énumère les interfaces logiques et physiques sur un système local et retourne ces informations dans une structure MIB_IF_TABLE2 . GetIfTable2 est une version améliorée de la fonction GetIfTable .

Une fonction GetIfTable2Ex similaire peut être utilisée pour spécifier le niveau d’interfaces à retourner. L’appel de la fonction GetIfTable2Ex avec le paramètre Level défini sur MibIfTableNormal récupère les mêmes résultats que l’appel de la fonction GetIfTable2 .

Les interfaces sont retournées dans une structure MIB_IF_TABLE2 dans la mémoire tampon pointée par le paramètre Table . La structure MIB_IF_TABLE2 contient un nombre d’interfaces et un tableau de structures MIB_IF_ROW2 pour chaque interface. La mémoire est allouée par la fonction GetIfTable2 pour la structure MIB_IF_TABLE2 et les entrées MIB_IF_ROW2 dans cette structure. Lorsque ces structures retournées ne sont plus nécessaires, libérez la mémoire en appelant FreeMibTable.

Notez que la structure de MIB_IF_TABLE2 retournée pointée par le paramètre Table peut contenir un remplissage pour l’alignement entre le membre NumEntries et la première entrée de tableau MIB_IF_ROW2 dans le membre Table de la structure MIB_IF_TABLE2 . Un remplissage pour l’alignement peut également être présent entre les entrées de tableau MIB_IF_ROW2 . Tout accès à une entrée de tableau MIB_IF_ROW2 doit supposer qu’un remplissage peut exister.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	netioapi.h (include Iphlpapi.h)
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll