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.

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

Voir aussi

FreeMibTable

GetIfTable

GetIfTable2Ex

Informations de référence sur les fonctions d’assistance IP

MIB_IF_ROW2

MIB_IF_TABLE2