Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Funkce FlushIpPathTable vyprázdní tabulku cest IP na místním počítači.
Syntax
NETIOAPI_API FlushIpPathTable(
_In_ ADDRESS_FAMILY Family
);
Parametry
rodinný [in]
Rodina adres, která se má vyprázdnit.Možné hodnoty pro řadu adres jsou uvedeny v souboru záhlaví Winsock2.h. Všimněte si, že hodnoty pro řadu AF_ adres a konstanty rodiny protokolu PF_ jsou stejné (například AF_INET a PF_INET), takže můžete použít kteroukoli konstantu.
V systému Windows Vista a novějších verzích operačních systémů Windows jsou možné hodnoty parametru Family definovány v souboru hlaviček Ws2def.h. Všimněte si, že soubor hlavičky Ws2def.h je automaticky zahrnutý v Netioapi.h a nikdy byste neměli používat Ws2def.h přímo.
Pro řadu adres se v současné době podporují následující hodnoty:
AF_INET
Řada adres IPv4. Pokud je tato hodnota zadaná, tato funkce vyprázdní tabulku cest IP, která obsahuje pouze položky IPv4.AF_INET6
Řada IPv6 adres. Pokud je tato hodnota zadaná, tato funkce vyprázdní tabulku cest IP, která obsahuje pouze položky IPv6.AF_UNSPEC
Řada adres není zadaná. Pokud je tato hodnota zadaná, tato funkce vyprázdní tabulku IP adres souseda, která obsahuje položky IPv4 i IPv6.
Návratová hodnota
FlushIpPathTable vrátí STATUS_SUCCESS, pokud bude funkce úspěšná.
Pokud funkce selže, FlushIpPathTable vrátí jeden z následujících kódů chyb:
| Návratový kód | Popis |
|---|---|
| STATUS_INVALID_PARAMETER | Funkci byla předána neplatná hodnota parametru. Tato chyba se vrátí, pokud parametr Family nebyl zadán jako AF_INET, AF_INET6 nebo AF_UNSPEC. |
| STATUS_NOT_SUPPORTED | Požadavek není podporován. Tato chyba se vrátí, pokud se na místním počítači nenachází žádný zásobník IPv4 a AF_INET byl zadán v parametru Family nebo pokud se v místním počítači nenachází zásobník IPv6 a AF_INET6 byl zadán v parametru Family. Tato chyba se také vrátí ve verzích Windows, kde tato funkce není podporovaná. |
| Jiné | Pomocí funkce FormatMessage získejte řetězec zprávy pro vrácenou chybu. |
Poznámky
Funkce FlushIpPathTable vyprázdní nebo odstraní položky cesty IP v místním počítači. Ovladač může pomocí parametru Family omezit položky cesty IP k odstranění na určitou řadu IP adres. Pokud by se měly odstranit položky cesty IP pro protokol IPv4 i IPv6, ovladač by měl nastavit parametr Family na AF_UNSPEC.
Ovladač musí inicializovat parametr Family na AF_INET, AF_INET6 nebo AF_UNSPEC.