FlushIpNetTable2, fonction
La fonction FlushIpNetTable2 vide la table IP voisine sur un ordinateur local.
Syntaxe
NETIOAPI_API FlushIpNetTable2(
_In_ ADDRESS_FAMILY Family,
_In_ NET_IFINDEX InterfaceIndex
);
Paramètres
Famille [in]
Famille d’adresses à vider.Les valeurs possibles pour la famille d’adresses sont répertoriées dans le fichier d’en-tête Winsock2.h. Notez que les valeurs de la famille d’adresses AF_ et des constantes de famille de protocole PF_ sont identiques (par exemple, AF_INET et PF_INET). Vous pouvez donc utiliser l’une ou l’autre constante.
Sur Windows Vista et les versions ultérieures des systèmes d’exploitation Windows, les valeurs possibles pour le paramètre Family sont définies dans le fichier d’en-tête Ws2def.h. Notez que le fichier d’en-tête Ws2def.h est automatiquement inclus dans Netioapi.h et que vous ne devez jamais utiliser Ws2def.h directement.
Les valeurs suivantes sont actuellement prises en charge pour la famille d’adresses :
AF_INET
Famille d’adresses IPv4. Lorsque cette valeur est spécifiée, cette fonction vide la table d’adresses IP voisine qui contient uniquement des entrées IPv4.AF_INET6
Famille d’adresses IPv6. Lorsque cette valeur est spécifiée, cette fonction vide la table d’adresses IP voisine qui contient uniquement des entrées IPv6.AF_UNSPEC
La famille d’adresses n’est pas spécifiée. Lorsque cette valeur est spécifiée, cette fonction vide la table d’adresses IP voisine qui contient les entrées IPv4 et IPv6.
InterfaceIndex [in]
Index de l’interface. Si l’index est spécifié, la fonction vide les entrées d’adresse IP voisines sur une interface spécifique. Sinon, la fonction vide les entrées d’adresse IP voisines sur toutes les interfaces. Pour ignorer l’interface, définissez ce paramètre sur zéro.
Valeur retournée
FlushIpNetTable2 retourne STATUS_SUCCESS si la fonction réussit.
Si la fonction échoue, FlushIpNetTable2 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 le paramètre Family n’a pas été spécifié comme AF_INET, AF_INET6 ou AF_UNSPEC. |
| STATUS_NOT_SUPPORTED | La demande n'est pas prise en charge. Cette erreur est retournée si aucune pile IPv4 ne se trouve sur l’ordinateur local et AF_INET a été spécifié dans le paramètre Family , ou si aucune pile IPv6 ne se trouve sur l’ordinateur local et AF_INET6 a été spécifié dans le paramètre Family . Cette erreur est également retournée sur les versions de Windows où cette fonction n’est pas prise en charge. |
| Autres | Utilisez la fonction FormatMessage pour obtenir la chaîne de message de l’erreur retournée. |
Notes
La fonction FlushIpNetTable2 vide ou supprime les adresses IP voisines sur un ordinateur local. Votre pilote peut utiliser le paramètre Family pour limiter les adresses IP voisines à supprimer à une famille d’adresses IP particulière. Si les adresses IP voisines pour IPv4 et IPv6 doivent être supprimées, votre pilote doit définir le paramètre Family sur AF_UNSPEC. Votre pilote peut utiliser le paramètre InterfaceIndex pour limiter la suppression d’adresses IP voisines à une interface particulière. Si les adresses IP voisines de toutes les interfaces doivent être supprimées, votre pilote doit définir le paramètre InterfaceIndex sur zéro.
Votre pilote doit initialiser le paramètre Family pour AF_INET, AF_INET6 ou AF_UNSPEC.
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 |