Funzione DeleteProxyArpEntry (iphlpapi.h)

La funzione DeleteProxyArpEntry elimina la voce PARP nel computer locale specificato dai parametri dwAddress e dwIfIndex .

Sintassi

IPHLPAPI_DLL_LINKAGE DWORD DeleteProxyArpEntry(
  [in] DWORD dwAddress,
  [in] DWORD dwMask,
  [in] DWORD dwIfIndex
);

Parametri

[in] dwAddress

Indirizzo IPv4 per il quale questo computer agisce come proxy.

[in] dwMask

Subnet mask per l'indirizzo IPv4 specificato nel parametro dwAddress .

[in] dwIfIndex

Indice dell'interfaccia in cui questo computer supporta proxy ARP per l'indirizzo IP specificato dal parametro dwAddress .

Valore restituito

La funzione restituisce NO_ERROR (zero) se la funzione ha esito positivo.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Codice restituito Descrizione
ERROR_ACCESS_DENIED
Accesso negato. Questo errore viene restituito in Windows Vista e Windows Server 2008 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).
ERROR_INVALID_PARAMETER
Un parametro di input non è valido, non è stata eseguita alcuna azione.
ERROR_NOT_SUPPORTED
Il trasporto IPv4 non è configurato nel computer locale.
Altri
Usare FormatMessage per ottenere la stringa di messaggio per l'errore restituito.

Commenti

Per recuperare la tabella ARP, chiamare la funzione GetIpNetTable .

In Windows Vista e versioni successive, la funzione DeleteProxyArpEntry può essere chiamata solo da un utente connesso come membro del gruppo Administrators. Se DeleteProxyArpEntry 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 in Windows Vista e versioni successive 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.

Nota Questa funzione esegue un'operazione con privilegi. Per eseguire correttamente questa funzione, il chiamante deve essere connesso come membro del gruppo Administrators o del gruppo NetworkConfigurationOperators.
 

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione iphlpapi.h
Libreria Iphlpapi.lib
DLL Iphlpapi.dll

Vedi anche

CreateProxyArpEntry

GetIpNetTable

Informazioni di riferimento sulla funzione helper IP

Pagina iniziale dell'helper IP

MIB_PROXYARP