Fonction InitializeIpInterfaceEntry
La fonction InitializeIpInterfaceEntry initialise les membres d’une entrée de structure MIB_IPINTERFACE_ROW avec les valeurs par défaut.
Syntaxe
VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
_Inout_ PMIB_IPINTERFACE_ROW Row
);
Paramètres
- Ligne [in, out]
Pointeur vers une structure MIB_IPINTERFACE_ROW à initialiser. En cas de retour réussi, les champs de ce paramètre sont initialisés avec les informations par défaut d’une interface sur l’ordinateur local.
Valeur retournée
InitializeIpInterfaceEntry retourne STATUS_SUCCESS si la fonction réussit.
Si la fonction échoue, InitializeIpInterfaceEntry retourne l’un des codes d’erreur suivants :
| Code de retour | Description |
|---|---|
| STATUS_INVALID_PARAMETER | Un paramètre non valide a été transmis à la fonction. Cette erreur est retournée si un pointeur NULL est passé dans le paramètre Row |
| Autres | Utilisez la fonction FormatMessage pour obtenir la chaîne de message de l’erreur retournée. |
Notes
Lors de la sortie, les membres de la structure MIB_IPINTERFACE_ROW vers laquelle pointe le paramètre Row sont initialisés comme suit.
Famille
Définissez sur AF_UNSPEC.InterfaceLuid
Définissez sur une valeur non spécifiée.Tous les autres membres
Définit la valeur zéro.
Votre pilote doit utiliser la fonction InitializeIpInterfaceEntry pour initialiser les champs d’une entrée de structure MIB_IPINTERFACE_ROW avec des valeurs par défaut. Un pilote peut ensuite modifier les champs de l’entrée MIB_IPINTERFACE_ROW qu’il souhaite modifier, puis appeler la fonction SetIpInterfaceEntry .
Spécifications
Plateforme cible |
Universal |
Version |
Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
En-tête |
Netioapi.h (inclure Netioapi.h) |
Bibliothèque |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |