Funzione FlushIpPathTable
La funzione FlushIpPathTable scarica la tabella del percorso IP in un computer locale.
Sintassi
NETIOAPI_API FlushIpPathTable(
_In_ ADDRESS_FAMILY Family
);
Parametri
famiglia [in]
Famiglia di indirizzi da scaricare.I valori possibili per la famiglia di indirizzi sono elencati nel file di intestazione Winsock2.h. Si noti che i valori per la famiglia di indirizzi AF_ e le costanti della famiglia di protocolli di PF_ sono identiche (ad esempio, AF_INET e PF_INET), in modo da poter usare una delle costanti.
In Windows Vista e versioni successive dei sistemi operativi Windows, i valori possibili per il parametro Family sono definiti nel file di intestazione Ws2def.h. Si noti che il file di intestazione Ws2def.h viene incluso automaticamente in Netioapi.h e non usare mai Ws2def.h direttamente.
Per la famiglia di indirizzi sono attualmente supportati i valori seguenti:
AF_INET
Famiglia di indirizzi IPv4. Quando questo valore viene specificato, questa funzione scarica la tabella del percorso IP che contiene solo le voci IPv4.AF_INET6
Famiglia di indirizzi IPv6. Quando questo valore viene specificato, questa funzione scarica la tabella del percorso IP che contiene solo le voci IPv6.AF_UNSPEC
La famiglia di indirizzi non è specificata. Quando questo valore viene specificato, questa funzione scarica la tabella degli indirizzi IP adiacenti che contiene sia le voci IPv4 che IPv6.
Valore restituito
FlushIpPathTable restituisce STATUS_SUCCESS se la funzione ha esito positivo.
Se la funzione non riesce, FlushIpPathTable restituisce uno dei codici di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Alla funzione è stato passato un parametro non valido. Questo errore viene restituito se il parametro famiglia di non è stato specificato come AF_INET, AF_INET6 o AF_UNSPEC. |
| STATUS_NOT_SUPPORTED | La richiesta non è supportata. Questo errore viene restituito se non si trova alcun stack IPv4 nel computer locale e AF_INET è stato specificato nel parametro famiglia di oppure se non si trova alcun stack IPv6 nel computer locale e AF_INET6 è stato specificato nel parametro famiglia di. Questo errore viene restituito anche nelle versioni di Windows in cui questa funzione non è supportata. |
| Altro | Usare la funzione FormatMessage per ottenere la stringa del messaggio per l'errore restituito. |
Osservazioni
La funzione FlushIpPathTable scarica o elimina le voci del percorso IP in un computer locale. Il driver può usare il parametro family per limitare le voci del percorso IP da eliminare a una determinata famiglia di indirizzi IP. Se le voci di percorso IP per IPv4 e IPv6 devono essere eliminate, il driver deve impostare il parametro family su AF_UNSPEC.
Il driver deve inizializzare il parametro Family per AF_INET, AF_INET6 o AF_UNSPEC.
Fabbisogno
Piattaforma di destinazione |
universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |