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 costante.
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.
I valori seguenti sono attualmente supportati per la famiglia di indirizzi:
AF_INET
Famiglia di indirizzi IPv4. Quando questo valore viene specificato, questa funzione scarica la tabella del percorso IP che contiene solo voci IPv4.AF_INET6
Famiglia di indirizzi IPv6. Quando questo valore viene specificato, questa funzione scarica la tabella del percorso IP che contiene solo 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 voci IPv4 che IPv6.
Valore restituito
FlushIpPathTable restituisce STATUS_SUCCESS se la funzione ha esito positivo.
Se la funzione ha esito negativo, FlushIpPathTable restituisce uno dei codici di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Un parametro non valido è stato passato alla funzione. Questo errore viene restituito se il parametro Family 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 Family o se non si trova alcun stack IPv6 nel computer locale e AF_INET6 è stato specificato nel parametro Family . Questo errore viene restituito anche nelle versioni di Windows in cui questa funzione non è supportata. |
| Altri | Utilizzare la funzione FormatMessage per ottenere la stringa di messaggio per l'errore restituito. |
Commenti
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 del 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 in AF_INET, AF_INET6 o AF_UNSPEC.
Requisiti
Piattaforma di destinazione |
Universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Libreria |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |