Funzione FlushIpNetTable2
La funzione FlushIpNetTable2 scarica la tabella adiacente IP in un computer locale.
Sintassi
NETIOAPI_API FlushIpNetTable2(
_In_ ADDRESS_FAMILY Family,
_In_ NET_IFINDEX InterfaceIndex
);
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 degli indirizzi IP adiacenti che contiene solo voci IPv4.AF_INET6
Famiglia di indirizzi IPv6. Quando si specifica questo valore, questa funzione scarica la tabella degli indirizzi IP adiacenti 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.
InterfaceIndex [in]
Indice dell'interfaccia. Se l'indice viene specificato, la funzione scarica le voci dell'indirizzo IP adiacente in un'interfaccia specifica. Ootherwise, la funzione scarica le voci dell'indirizzo IP adiacente in tutte le interfacce. Per ignorare l'interfaccia, impostare questo parametro su zero.
Valore restituito
FlushIpNetTable2 restituisce STATUS_SUCCESS se la funzione ha esito positivo.
Se la funzione non riesce, FlushIpNetTable2 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 FlushIpNetTable2 scarica o elimina gli indirizzi IP adiacenti in un computer locale. Il driver può usare il parametro famiglia di per limitare gli indirizzi IP adiacenti da eliminare a una determinata famiglia di indirizzi IP. Se gli indirizzi IP adiacenti per IPv4 e IPv6 devono essere eliminati, il driver deve impostare il parametro famiglia di su AF_UNSPEC. Il driver può usare il parametro InterfaceIndex per limitare gli indirizzi IP adiacenti da eliminare a una particolare interfaccia. Se gli indirizzi IP adiacenti per tutte le interfacce devono essere eliminati, il driver deve impostare il parametro InterfaceIndex su zero.
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 |