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 identici (ad esempio, AF_INET e PF_INET), in modo da poter usare entrambe le 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 è mai consigliabile usare direttamente Ws2def.h.
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 degli indirizzi IP adiacenti che contiene solo voci IPv4.AF_INET6
Famiglia di indirizzi IPv6. Quando questo valore viene specificato, 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 ha esito negativo, 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 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 oppure 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 FlushIpNetTable2 scarica o elimina gli indirizzi IP adiacenti in un computer locale. Il driver può usare il parametro Family 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 Family su AF_UNSPEC. Il driver può usare il parametro InterfaceIndex per limitare gli indirizzi IP adiacenti da eliminare a una determinata 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.
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 |