Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Met de functie FlushIpNetTable2 wordt de tabel IP-buren op een lokale computer leeggemaakt.
Syntaxis
NETIOAPI_API FlushIpNetTable2(
_In_ ADDRESS_FAMILY Family,
_In_ NET_IFINDEX InterfaceIndex
);
Parameters
Family [in]
De adresfamilie die moet worden leeggemaakt.Mogelijke waarden voor de adresfamilie worden vermeld in het headerbestand Winsock2.h. Houd er rekening mee dat de waarden voor de AF_-adresfamilie en PF_ protocolfamilieconstanten identiek zijn (bijvoorbeeld AF_INET en PF_INET), zodat u beide constanten kunt gebruiken.
In Windows Vista en latere versies van de Windows-besturingssystemen worden mogelijke waarden voor de parameter Family gedefinieerd in het headerbestand Ws2def.h. Houd er rekening mee dat het headerbestand Ws2def.h automatisch wordt opgenomen in Netioapi.h en dat u Ws2def.h nooit rechtstreeks moet gebruiken.
De volgende waarden worden momenteel ondersteund voor de adresfamilie:
AF_INET
De IPv4-adresfamilie. Wanneer deze waarde is opgegeven, wordt met deze functie de ip-adrestabel van de buur leeggemaakt die alleen IPv4-vermeldingen bevat.AF_INET6
De IPv6-adresfamilie. Wanneer deze waarde is opgegeven, wordt met deze functie de ip-adrestabel van de buur leeggemaakt die alleen IPv6-vermeldingen bevat.AF_UNSPEC
De adresfamilie is niet opgegeven. Wanneer deze waarde is opgegeven, wordt met deze functie de ip-adrestabel van de buur leeggemaakt die zowel IPv4- als IPv6-vermeldingen bevat.
InterfaceIndex [in]
De interface-index. Als de index is opgegeven, worden met de functie de ip-adresvermeldingen van de buur op een specifieke interface leeggemaakt. Met de functie worden de ip-adresvermeldingen van de buren op alle interfaces leeggemaakt. Als u de interface wilt negeren, stelt u deze parameter in op nul.
Retourwaarde
FlushIpNetTable2 retourneert STATUS_SUCCESS als de functie slaagt.
Als de functie mislukt, retourneert FlushIpNetTable2 een van de volgende foutcodes:
| Retourcode | Beschrijving |
|---|---|
| STATUS_INVALID_PARAMETER | Er is een ongeldige parameter doorgegeven aan de functie. Deze fout wordt geretourneerd als de parameter Family niet is opgegeven als AF_INET, AF_INET6 of AF_UNSPEC. |
| STATUS_NOT_SUPPORTED | De aanvraag wordt niet ondersteund. Deze fout wordt geretourneerd als er geen IPv4-stack zich op de lokale computer bevindt en AF_INET is opgegeven in de parameter Family, of als er geen IPv6-stack zich op de lokale computer bevindt en AF_INET6 is opgegeven in de parameter Family. Deze fout wordt ook geretourneerd in versies van Windows waarbij deze functie niet wordt ondersteund. |
| Overige | Gebruik de functie FormatMessage om de berichttekenreeks voor de geretourneerde fout op te halen. |
Opmerkingen
Met de functie FlushIpNetTable2 worden de IP-adressen van de buren op een lokale computer leeggemaakt of verwijderd. Uw stuurprogramma kan de parameter Family gebruiken om ip-adressen van buren te beperken tot een bepaalde IP-adresfamilie. Als ip-adressen van buren voor zowel IPv4 als IPv6 moeten worden verwijderd, moet het stuurprogramma de parameter Family instellen op AF_UNSPEC. Uw stuurprogramma kan de parameter InterfaceIndex gebruiken om ip-adressen van buren te beperken om te verwijderen naar een bepaalde interface. Als naburige IP-adressen voor alle interfaces moeten worden verwijderd, moet het stuurprogramma de InterfaceIndex parameter instellen op nul.
Uw stuurprogramma moet de parameter Family initialiseren voor AF_INET, AF_INET6 of AF_UNSPEC.
Eisen
Doelplatform |
Universal |
Versie |
Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen. |
Rubriek |
Netioapi.h (inclusief Netioapi.h) |
Bibliotheek |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |