Funktionen FlushIpPathTable

Funktionen FlushIpPathTable rensar ip-sökvägstabellen på en lokal dator.

Syntax

NETIOAPI_API FlushIpPathTable(
  _In_ ADDRESS_FAMILY Family
);

Parametrar

• Family [in]
  Adressfamiljen som ska tömmas.

  Möjliga värden för adressfamiljen visas i sidhuvudfilen Winsock2.h. Observera att värdena för AF_-adressfamiljen och PF_ protokollfamiljens konstanter är identiska (till exempel AF_INET och PF_INET), så du kan använda någon av konstanterna.

  I Windows Vista och senare versioner av Windows-operativsystem definieras möjliga värden för parametern Family i rubrikfilen Ws2def.h. Observera att Ws2def.h-huvudfilen automatiskt ingår i Netioapi.h och att du aldrig bör använda Ws2def.h direkt.

  Följande värden stöds för närvarande för adressfamiljen:

  • AF_INET
    IPv4-adressfamiljen. När det här värdet anges rensar den här funktionen ip-sökvägstabellen som endast innehåller IPv4-poster.

  • AF_INET6
    IPv6-adressfamiljen. När det här värdet anges rensar den här funktionen ip-sökvägstabellen som endast innehåller IPv6-poster.

  • AF_UNSPEC
    Adressfamiljen är ospecificerad. När det här värdet anges rensar den här funktionen den angränsande IP-adresstabellen som innehåller både IPv4- och IPv6-poster.

Returvärde

FlushIpPathTable returnerar STATUS_SUCCESS om funktionen lyckas.

Om funktionen misslyckas returnerar FlushIpPathTable någon av följande felkoder:

Returnera kod	Beskrivning
STATUS_INVALID_PARAMETER	En ogiltig parameter skickades till funktionen. Det här felet returneras om parametern Family inte har angetts som AF_INET, AF_INET6 eller AF_UNSPEC.
STATUS_NOT_SUPPORTED	Begäran stöds inte. Det här felet returneras om ingen IPv4-stack finns på den lokala datorn och AF_INET angavs i parametern Family, eller om ingen IPv6-stack finns på den lokala datorn och AF_INET6 angavs i parametern Family. Det här felet returneras också i versioner av Windows där den här funktionen inte stöds.
Andra	Använd funktionen FormatMessage för att hämta meddelandesträngen för det returnerade felet.

Anmärkningar

Funktionen FlushIpPathTable rensar eller tar bort IP-sökvägsposterna på en lokal dator. Drivrutinen kan använda parametern Family för att begränsa IP-sökvägens poster att ta bort till en viss IP-adressfamilj. Om IP-sökvägsposter för både IPv4 och IPv6 ska tas bort bör drivrutinen ange parametern Family till AF_UNSPEC.

Drivrutinen måste initiera parametern Family till antingen AF_INET, AF_INET6 eller AF_UNSPEC.

Krav

Målplattform	Universell
Version	Finns i Windows Vista och senare versioner av Windows-operativsystemen.
Rubrik	Netioapi.h (inkludera Netioapi.h)
Bibliotek	Netio.lib
IRQL	< DISPATCH_LEVEL

Se även

GetIpPathEntry

GetIpPathTable

MIB_IPPATH_ROW

MIB_IPPATH_TABLE