Funzione DeleteIpNetEntry2

La funzione DeleteIpNetEntry2 elimina una voce di indirizzo IP adiacente in un computer locale.

Sintassi

NETIOAPI_API DeleteIpNetEntry2(
  _In_ const MIB_IPNET_ROW2 *Row
);

Parametri

• riga [in]
  Puntatore a una voce della struttura MIB_IPNET_ROW2 per una voce di indirizzo IP adiacente. In caso di esito positivo, questa voce viene eliminata.

Valore restituito

deleteIpNetEntry2 restituisce STATUS_SUCCESS se la funzione ha esito positivo.

Se la funzione non riesce, DeleteIpNetEntry2 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 un puntatore NULL viene passato nel parametro row, Il membro Address della struttura MIB_IPNET_ROW2 a cui punta il parametro Row non è stato impostato su un indirizzo IPv4 o IPv6 valido oppure entrambi InterfaceLuid e InterfaceIndex membri della struttura MIB_IPNET_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 InterfaceLuid o InterfaceIndex membro della struttura MIB_IPNET_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 Address della struttura MIB_IPNET_ROW2 a cui punta il parametro riga oppure se non si trova alcun stack IPv6 nel computer locale e un indirizzo IPv6 è stato specificato nel membro Address.
Altro	Usare la funzione FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

Osservazioni

La funzione di DeleteIpNetEntry2 viene usata per eliminare una voce di struttura MIB_IPNET_ROW2.

All'input, il driver deve inizializzare i membri seguenti della struttura MIB_IPNET_ROW2 a cui punta il parametro Row.

• Address
  Impostare su un indirizzo e una famiglia IPv6 IPv4 o IPv6 validi.

• InterfaceLuid o InterfaceIndex
  Questi membri vengono utilizzati nell'ordine elencato in precedenza. Pertanto, se si specifica InterfaceLuid, 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.

Quando la chiamata ha esito positivo, DeleteIpNetEntry2 elimina l'indirizzo IP adiacente.

Il driver può chiamare la funzioneGetIpNetTable2per enumerare le voci dell'indirizzo IP adiacente in un computer locale.

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

Vedere anche

CreateIpNetEntry2

FlushIpNetTable2

getIpNetEntry2

GetIpNetTable2

MIB_IPNET_ROW2

MIB_IPNET_TABLE2

ResolveIpNetEntry2

SetIpNetEntry2