Fonction GetIfEntry2
La fonction GetIfEntry2 récupère des informations pour l’interface spécifiée sur un ordinateur local.
Important
Pour les développeurs de pilotes, il est recommandé d’utiliser GetIfEntry2Ex avec MibIfEntryNormalWithoutStatistics lorsque cela est possible, afin d’éviter un blocage lors du traitement des OIDs NDIS.
Syntaxe
NETIOAPI_API GetIfEntry2(
_Inout_ PMIB_IF_ROW2 Row
);
Paramètres
- Row [entrée, sortie]
Un pointeur vers une structure MIB_IF_ROW2 qui, en cas de réussite, reçoit des informations pour une interface sur l’ordinateur local. À l’entrée, votre pilote doit définir le membre InterfaceLuid ou le membre InterfaceIndex de la structure MIB_IF_ROW2 pour l’interface dont les informations doivent être récupérées.
Valeur retournée
GetIfEntry2 retourne STATUS_SUCCESS si la fonction réussit.
Si la fonction échoue, GetIfEntry2 renvoie l’un des codes d’erreur suivants :
| Code de retour | Description |
|---|---|
| STATUS_INVALID_PARAMETER | Un paramètre non valide a été passé à la fonction. Cette erreur est renvoyée si un pointeur NULL est passé dans le paramètre Row. |
| STATUS_NOT_FOUND | L’interface spécifiée n’a pas pu être trouvée. Cette erreur est renvoyée si la fonction ne peut pas trouver l’interface réseau spécifiée par le membre InterfaceLuid ou InterfaceIndex de la structure MIB_IF_ROW2 vers laquelle le paramètre Row pointe. |
| Autres | Utilisez la fonction FormatMessage pour obtenir la chaîne de message correspondant à l’erreur renvoyée. |
Notes
À l’entrée, votre pilote doit initialiser au moins le membre InterfaceLuid ou InterfaceIndex de la structure MIB_IF_ROW2 passée dans le paramètre Row. Les membres sont utilisés dans l’ordre indiqué précédemment. Ainsi, si InterfaceLuid est spécifié, ce membre est utilisé pour déterminer l’interface. Si aucune valeur n’a été définie pour le membre InterfaceLuid (la valeur de ce membre a été définie à zéro), le membre InterfaceIndex est ensuite utilisé pour déterminer l’interface.
En sortie, les champs restants de la structure MIB_IF_ROW2 vers laquelle le paramètre Row pointe sont remplis.
Spécifications
Plateforme cible |
Universal |
Version |
Disponible sous Windows Vista et les versions ultérieures du système d’exploitation Windows. |
En-tête |
Netioapi.h (inclure Netioapi.h) |
Bibliothèque |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |