Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La fonction GetInvertedIfStackTable récupère une table des entrées de ligne de pile d’interface réseau inversées qui spécifient la relation des interfaces réseau sur une pile d’interface.
Syntaxe
NETIOAPI_API GetInvertedIfStackTable(
_Out_ PMIB_INVERTEDIFSTACK_TABLE *Table
);
Paramètres
-
table [out]
Pointeur vers une mémoire tampon qui reçoit la table des entrées de ligne de pile d’interface inversée dans une structure MIB_INVERTEDIFSTACK_TABLE.
Valeur de retour
GetInvertedIfStackTable retourne STATUS_SUCCESS si la fonction réussit.
Si la fonction échoue, GetInvertedIfStackTable retourne l’un des codes d’erreur suivants :
| Retourner le code | Description |
|---|---|
| STATUS_INVALID_PARAMETER | Un paramètre non valide a été passé à la fonction. Cette erreur est retournée si un pointeur NULL est transmis dans le paramètre table. |
| STATUS_NOT_ENOUGH_MEMORY | Les ressources de mémoire insuffisantes sont disponibles pour terminer l’opération. |
| STATUS_NOT_FOUND | Aucune entrée de pile d’interface n’a été trouvée. |
| autres | Utilisez la fonction FormatMessage pour obtenir la chaîne de message pour l’erreur retournée. |
Remarques
La fonction GetInvertedIfStackTable énumère les interfaces réseau physiques et logiques sur une pile d’interfaces sur un ordinateur local et retourne ces informations dans un formulaire inversé dans la structure MIB_INVERTEDIFSTACK_TABLE.
GetInvertedIfStackTable retourne des entrées de pile d’interface dans une structure MIB_INVERTEDIFSTACK_TABLE dans la mémoire tampon vers laquelle pointe le paramètre Table. La structure MIB_INVERTEDIFSTACK_TABLE contient un nombre d’entrées de pile d’interface et un tableau de structures MIB_INVERTEDIFSTACK_ROW pour chaque entrée de pile d’interface.
La relation entre les interfaces de la pile d’interface est que l’interface avec un index dans la HigherLayerInterfaceIndex membre de la structure MIB_INVERTEDIFSTACK_ROW est immédiatement au-dessus de l’interface avec l’index dans la LowerLayerInterfaceIndex membre de la structure MIB_INVERTEDIFSTACK_ROW.
GetInvertedIfStackTable alloue de la mémoire pour la structure MIB_INVERTEDIFSTACK_TABLE et les entrées MIB_INVERTEDIFSTACK_ROW 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_INVERTEDIFSTACK_TABLE 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_INVERTEDIFSTACK_ROW dans le membre table de la structure MIB_INVERTEDIFSTACK_TABLE. Le remplissage pour l’alignement peut également être présent entre les entrées de tableau MIB_INVERTEDIFSTACK_ROW. Tout accès à une entrée de tableau MIB_INVERTEDIFSTACK_ROW doit supposer que le remplissage peut exister.