Funzione DeleteAnycastIpAddressEntry (netioapi.h)
La funzione DeleteAnycastIpAddressEntry elimina una voce di indirizzo IP anycast esistente nel computer locale.
Sintassi
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API DeleteAnycastIpAddressEntry(
[in] const MIB_ANYCASTIPADDRESS_ROW *Row
);
Parametri
[in] Row
Puntatore a una voce di struttura MIB_ANYCASTIPADDRESS_ROW per una voce di indirizzo IP anycast esistente da eliminare dal computer locale.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è NO_ERROR.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Accesso negato. Questo errore viene restituito in diverse condizioni che includono quanto segue: l'utente non dispone dei privilegi amministrativi necessari nel computer locale o l'applicazione non è in esecuzione in una shell avanzata come amministratore predefinito (amministratore RunAs). |
|
Un parametro non valido è stato passato alla funzione. Questo errore viene restituito se un puntatore NULL viene passato nel parametro Row, il membro Address del MIB_ANYCASTIPADDRESS_ROW puntato al parametro Row non è stato impostato su un indirizzo IPv4 o IPv6 valido oppure entrambi i membri InterfaceLuid o InterfaceIndexMIB_ANYCASTIPADDRESS_ROW del parametroRow non sono stati specificati. |
|
Impossibile trovare l'interfaccia specificata. Questo errore viene restituito se non è stato possibile trovare l'interfaccia di rete specificata dal membro InterfaceLuid o InterfaceIndex del MIB_ANYCASTIPADDRESS_ROW puntato dal parametro Row . |
|
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 AddressMIB_ANYCASTIPADDRESS_ROW puntato dal parametro Row . Questo errore viene restituito anche se non è presente alcun stack IPv6 nel computer locale e un indirizzo IPv6 è stato specificato nel membro Address . |
|
Usare FormatMessage per ottenere la stringa di messaggio per l'errore restituito. |
Commenti
La funzione DeleteAnycastIpAddressEntry è definita in Windows Vista e versioni successive.
La funzione DeleteAnycastIpAddressEntry viene usata per eliminare una voce di struttura MIB_ANYCASTIPADDRESS_ROW esistente nel computer locale.
In input, il membro Address nella struttura MIB_ANYCASTIPADDRESS_ROW puntato al parametro Row deve essere impostato su un indirizzo IPv4 o IPv6 valido. Inoltre, almeno uno dei membri seguenti nella struttura MIB_ANYCASTIPADDRESS_ROW punta al parametro Row deve essere inizializzato: InterfaceLuid o InterfaceIndex.
I campi vengono usati nell'ordine elencato sopra. Quindi, se si specifica InterfaceLuid , questo membro viene usato per determinare l'interfaccia. Se non è stato impostato alcun valore per il membro InterfaceLuid (i valori 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.
La funzione GetAnycastIpAddressTable può essere chiamata per enumerare le voci degli indirizzi IP anycast in un computer locale. La funzione GetAnycastIpAddressEntry può essere chiamata per recuperare una voce di indirizzo IP anycast esistente specifica.
La funzione DeleteAnycastIpAddressEntry può essere chiamata solo da un utente connesso come membro del gruppo Administrators. Se DeleteAnycastIpAddressEntry viene chiamato da un utente che non è membro del gruppo Administrators, la chiamata alla funzione avrà esito negativo e ERROR_ACCESS_DENIED viene restituita. Questa funzione può anche non riuscire a causa del controllo account utente (UAC) in Windows Vista e versioni successive. Se un'applicazione contenente questa funzione viene eseguita da un utente connesso come membro del gruppo Administrators diverso dall'amministratore predefinito, questa chiamata avrà esito negativo a meno che l'applicazione non sia stata contrassegnata nel file manifesto con un set requestedExecutionLevel per richiedereAdministrator. Se l'applicazione manca di questo file manifesto, un utente ha eseguito l'accesso come membro del gruppo Administrators diverso dall'amministratore predefinito, deve quindi eseguire l'applicazione in una shell avanzata come amministratore predefinito (amministratore RunAs) per la riuscita di questa funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | netioapi.h (includere Iphlpapi.h) |
| Libreria | Iphlpapi.lib |
| DLL | Iphlpapi.dll |