Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Funkcja FlushIpNetTable2 opróżnia tabelę sąsiadów IP na komputerze lokalnym.
Składnia
NETIOAPI_API FlushIpNetTable2(
_In_ ADDRESS_FAMILY Family,
_In_ NET_IFINDEX InterfaceIndex
);
Parametry
rodziny [in]
Rodzina adresów do opróżnienia.Możliwe wartości rodziny adresów są wymienione w pliku nagłówka Winsock2.h. Należy pamiętać, że wartości rodziny adresów AF_ i rodziny protokołów PF_ są identyczne (na przykład AF_INET i PF_INET), aby można było użyć dowolnej stałej.
W systemie Windows Vista i nowszych wersjach systemów operacyjnych Windows możliwe wartości parametru Family są zdefiniowane w pliku nagłówka Ws2def.h. Należy pamiętać, że plik nagłówka Ws2def.h jest automatycznie dołączany do pliku Netioapi.h i nigdy nie należy bezpośrednio używać pliku Ws2def.h.
Dla rodziny adresów są obecnie obsługiwane następujące wartości:
AF_INET
Rodzina adresów IPv4. Po określeniu tej wartości ta funkcja opróżnia tabelę adresów IP sąsiada zawierającą tylko wpisy IPv4.AF_INET6
Rodzina adresów IPv6. Po określeniu tej wartości ta funkcja opróżnia tabelę adresów IP sąsiada zawierającą tylko wpisy IPv6.AF_UNSPEC
Rodzina adresów nie jest określona. Po określeniu tej wartości ta funkcja opróżnia tabelę adresów IP sąsiada zawierającą wpisy IPv4 i IPv6.
InterfaceIndex [in]
Indeks interfejsu. Jeśli indeks zostanie określony, funkcja opróżnia wpisy adresu IP sąsiada w określonym interfejsie. Ootherwise funkcja opróżnia wpisy adresu IP sąsiada we wszystkich interfejsach. Aby zignorować interfejs, ustaw ten parametr na zero.
Wartość zwracana
FlushIpNetTable2 zwraca STATUS_SUCCESS, jeśli funkcja powiedzie się.
Jeśli funkcja nie powiedzie się, FlushIpNetTable2 zwraca jeden z następujących kodów błędów:
| Kod powrotny | Opis |
|---|---|
| STATUS_INVALID_PARAMETER | Do funkcji przekazano nieprawidłowy parametr. Ten błąd jest zwracany, jeśli parametr rodziny nie został określony jako AF_INET, AF_INET6 lub AF_UNSPEC. |
| STATUS_NOT_SUPPORTED | Żądanie nie jest obsługiwane. Ten błąd jest zwracany, jeśli żaden stos IPv4 nie znajduje się na komputerze lokalnym i AF_INET został określony w parametrze rodziny lub jeśli na komputerze lokalnym nie znajduje się stos IPv6 i AF_INET6 został określony w parametrze rodziny. Ten błąd jest również zwracany w wersjach systemu Windows, w których ta funkcja nie jest obsługiwana. |
| inne | Użyj funkcji FormatMessage, aby uzyskać ciąg komunikatu dla zwróconego błędu. |
Uwagi
Funkcja FlushIpNetTable2 opróżnia lub usuwa adresy IP sąsiada na komputerze lokalnym. Sterownik może użyć parametru Family, aby ograniczyć adresy IP sąsiadów do usunięcia do określonej rodziny adresów IP. Jeśli należy usunąć adresy IP sąsiada dla protokołów IPv4 i IPv6, sterownik powinien ustawić parametr rodziny na AF_UNSPEC. Sterownik może użyć parametru InterfaceIndex, aby ograniczyć adresy IP sąsiadów do usunięcia do określonego interfejsu. Jeśli adresy IP sąsiada dla wszystkich interfejsów powinny zostać usunięte, sterownik powinien ustawić parametr InterfaceIndex na zero.
Sterownik musi zainicjować parametr rodziny do AF_INET, AF_INET6 lub AF_UNSPEC.
Wymagania
Platforma docelowa |
universal |
Wersja |
Dostępne w systemie Windows Vista i nowszych wersjach systemów operacyjnych Windows. |
Nagłówek |
Netioapi.h (include Netioapi.h) |
Biblioteka |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |