Funzione DeleteAnycastIpAddressEntry

La funzione DeleteAnycastIpAddressEntry elimina una voce di indirizzo IP anycast esistente in un computer locale.

Sintassi

NETIOAPI_API DeleteAnycastIpAddressEntry(
  _In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);

Parametri

• riga [in]
  Puntatore a una voce della struttura MIB_ANYCASTIPADDRESS_ROW per una voce di indirizzo IP anycast esistente da eliminare dal computer locale.

Valore restituito

DeleteAnycastIpAddressEntry restituisce STATUS_SUCCESS se la funzione ha esito positivo.

Se la funzione non riesce, DeleteAnycastIpAddressEntry 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 di MIB_ANYCASTIPADDRESS_ROW a cui punta il parametro Row non è stato impostato su un indirizzo IPv4 o IPv6 valido oppure entrambi i membri InterfaceLuid e interfaceIndex membri della struttura MIB_ANYCASTIPADDRESS_ROW 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 membro InterfaceIndex della struttura MIB_ANYCASTIPADDRESS_ROW 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_ANYCASTIPADDRESS_ROW 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 DeleteAnycastIpAddressEntry viene utilizzata per eliminare una voce di struttura MIB_ANYCASTIPADDRESS_ROW esistente nel computer locale.

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

• Address
  Impostare su un indirizzo e una famiglia IPv4 o IPv6 unicast 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.

Se la funzione ha esito positivo, l'indirizzo IP esistente rappresentato dal parametro Row è stato eliminato.

Il driver può chiamare la funzioneGetAnycastIpAddressTableper enumerare le voci di indirizzo IP anycast in un computer locale. Il driver può chiamare la funzione GetAnycastIpAddressEntry per recuperare una voce di indirizzo IP anycast esistente specifica.

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

CreateAnycastIpAddressEntry

GetAnycastIpAddressEntry

GetAnycastIpAddressTable

MIB_ANYCASTIPADDRESS_ROW

MIB_ANYCASTIPADDRESS_TABLE