GetIfTable2, fonction (netioapi.h)
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 |
|---|---|
|
Les ressources de mémoire sont insuffisantes pour terminer l’opération. |
|
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 |