Funzione DeleteIpForwardEntry2
La funzione DeleteIpForwardEntry2 elimina una voce di route IP in un computer locale.
Sintassi
NETIOAPI_API DeleteIpForwardEntry2(
_In_ const MIB_IPFORWARD_ROW2 *Row
);
Parametri
- Riga [in]
Puntatore a una voce di struttura MIB_IPFORWARD_ROW2 per una voce di route IP. Al termine della restituzione, questa voce viene eliminata.
Valore restituito
DeleteIpForwardEntry2 restituisce STATUS_SUCCESS se la funzione ha esito positivo.
Se la funzione ha esito negativo, DeleteIpForwardEntry2 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 un puntatore NULL viene passato nel parametro Row, il membro DestinationPrefix della struttura MIB_IPFORWARD_ROW2 che il parametro Row punta a non è stato specificato, il membro NextHop della struttura MIB_IPFORWARD_ROW2 non è stato specificato o i membri InterfaceLuid e InterfaceIndex della struttura MIB_IPFORWARD_ROW2 non sono stati specificati. |
| STATUS_NOT_FOUND | Impossibile trovare l'interfaccia specificata. Questo errore viene restituito se la funzione non riesce a trovare l'interfaccia di rete specificata dal membro InterfaceLuid o InterfaceIndex della struttura MIB_IPFORWARD_ROW2 a cui punta il parametro Row . |
| STATUS_NOT_SUPPORTED | La richiesta non è supportata. Questo errore viene restituito se non si trova alcun stack IPv4 nel computer locale e un indirizzo IPv4 è stato specificato nel membro Indirizzo della struttura MIB_IPFORWARD_ROW2 a cui punta il parametro Row o se non si trova alcun stack IPv6 nel computer locale e un indirizzo IPv6 è stato specificato nel membro Address . |
| Altri | Utilizzare la funzione FormatMessage per ottenere la stringa di messaggio per l'errore restituito. |
Commenti
La funzione DeleteIpForwardEntry2 viene usata per eliminare una voce di struttura MIB_IPFORWARD_ROW2 .
In input, il driver deve inizializzare i membri seguenti della struttura MIB_IPFORWARD_ROW2 a cui punta il parametro Row .
DestinationPrefix
Impostare su un prefisso e una famiglia di indirizzi IPv4 o IPv6 validi.NextHop
Impostare su un indirizzo IPv4 o IPv6 valido e una famiglia.InterfaceLuid o InterfaceIndex
Questi membri vengono usati nell'ordine elencato in precedenza. Quindi, se InterfaceLuid viene specificato, questo membro viene usato per determinare l'interfaccia. Se non è stato impostato alcun valore per il membro InterfaceLuid (il valore di questo membro è stato impostato su zero), il membro InterfaceIndex viene usato successivamente per determinare l'interfaccia.
Nell'output, quando la chiamata ha esito positivo, DeleteIpForwardEntry2 elimina la voce di route IP.
La funzione DeleteIpForwardEntry2 non riesce se i membri DestinationPrefix e NextHop della struttura MIB_IPFORWARD_ROW2 che il parametro Row punta a non corrispondere a una voce di route IP esistente nell'interfaccia specificata nei membri InterfaceLuid o InterfaceIndex .
Il driver può chiamare la funzione GetIpForwardTable2 per enumerare le voci di route IP in un computer locale.
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 |