GetIfTable2, fonction
La fonction GetIfTable2 récupère la table d’interface MIB-II.
Syntaxe
NETIOAPI_API GetIfTable2(
_Out_ PMIB_IF_TABLE2 *Table
);
Paramètres
-
table [out]
Pointeur vers une mémoire tampon qui reçoit la table des interfaces dans une structure MIB_IF_TABLE2.
Valeur de retour
GetIfTable2 retourne STATUS_SUCCESS si la fonction réussit.
Si la fonction échoue, GetIfTable2 retourne l’un des codes d’erreur suivants :
| Retourner le code | Description |
|---|---|
| STATUS_NOT_ENOUGH_MEMORY | Les ressources de mémoire insuffisantes sont disponibles pour terminer l’opération. |
| autres | Utilisez la fonction FormatMessage pour obtenir la chaîne de message pour l’erreur retournée. |
Remarques
La fonction GetIfTable2 énumère les interfaces logiques et physiques sur un ordinateur local et retourne ces informations dans une structure MIB_IF_TABLE2.
Votre pilote peut utiliser une fonction similaire, GetIfTable2Ex, pour spécifier le niveau d’interfaces à retourner. Un appel à 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.
GetIfTable2 retourne des interfaces dans une structure MIB_IF_TABLE2 dans la mémoire tampon vers laquelle pointe 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. GetIfTable2 alloue de la mémoire pour la structure MIB_IF_TABLE2 et les entrées MIB_IF_ROW2 de cette structure. Lorsque ces structures retournées ne sont plus requises, votre pilote doit libérer la mémoire en appelant FreeMibTable.
Notez que la structure MIB_IF_TABLE2 retournée par laquelle 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. Le remplissage pour l’alignement peut également être présent entre les entrées du tableau MIB_IF_ROW2. Tout accès à une entrée de tableau MIB_IF_ROW2 doit supposer que le remplissage peut exister.