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 retournée
GetIfTable2 retourne STATUS_SUCCESS si la fonction réussit.
Si la fonction échoue, GetIfTable2 retourne l’un des codes d’erreur suivants :
| Code de retour | Description |
|---|---|
| STATUS_NOT_ENOUGH_MEMORY | Des 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. |
Notes
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 dans cette structure. Lorsque ces structures retournées ne sont plus nécessaires, votre pilote doit libérer la mémoire en appelant FreeMibTable.
Notez que la structure de MIB_IF_TABLE2 renvoyée vers laquelle pointe 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 de tableau MIB_IF_ROW2. Tout accès à une entrée de tableau MIB_IF_ROW2 doit supposer que le remplissage peut exister.
Spécifications
Plateforme cible |
Universal |
Version |
Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows. |
En-tête |
Netioapi.h (inclure Netioapi.h) |
Bibliothèque |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |