GetIfEntry2, fonction
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 si possible, afin d’éviter un blocage lors de la maintenance des OID NDIS.
Syntaxe
NETIOAPI_API GetIfEntry2(
_Inout_ PMIB_IF_ROW2 Row
);
Paramètres
-
ligne [in, out]
Pointeur vers une structure MIB_IF_ROW2 qui, lors d’un retour réussi, reçoit des informations pour une interface sur l’ordinateur local. Lors de l’entrée, votre pilote doit définir le membre interfaceLuid ou le membre InterfaceIndex de la structure MIB_IF_ROW2 à l’interface pour récupérer des informations.
Valeur de retour
GetIfEntry2 retourne STATUS_SUCCESS si la fonction réussit.
Si la fonction échoue, GetIfEntry2 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 Ligne. |
| STATUS_NOT_FOUND | L’interface spécifiée est introuvable. Cette erreur est retournée si la fonction ne trouve pas l’interface réseau spécifiée par l'InterfaceLuid ou le membre InterfaceIndex de la structure MIB_IF_ROW2 vers laquelle pointe le paramètre Row. |
| autres | Utilisez la fonction FormatMessage pour obtenir la chaîne de message pour l’erreur retournée. |
Remarques
Lors de l’entrée, votre pilote doit initialiser au moins le membre InterfaceLuid ou InterfaceIndex dans la structure MIB_IF_ROW2 passée dans le paramètre ligne. Les membres sont utilisés dans l’ordre répertorié précédemment. Par conséquent, 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 sur zéro), le membre InterfaceIndex est ensuite utilisé pour déterminer l’interface.
Lors de la sortie, les champs restants de la structure MIB_IF_ROW2 que les points de paramètre ligne doivent être renseignés.