Funzione CreateProxyArpEntry (iphlpapi.h)
La funzione CreateProxyArpEnry crea una voce PARP (Proxy Address Resolution Protocol) nel computer locale per l'indirizzo IPv4 specificato.
Sintassi
IPHLPAPI_DLL_LINKAGE DWORD CreateProxyArpEntry(
[in] DWORD dwAddress,
[in] DWORD dwMask,
[in] DWORD dwIfIndex
);
Parametri
[in] dwAddress
Indirizzo IPv4 per il quale il computer funge da proxy.
[in] dwMask
Subnet mask per l'indirizzo IPv4 specificato in dwAddress.
[in] dwIfIndex
Indice dell'interfaccia in cui eseguire il proxy ARP per l'indirizzo IPv4 identificato da dwAddress. In altre parole, quando viene ricevuta una richiesta ARP per dwAddress in questa interfaccia, il computer locale risponde con l'indirizzo fisico di questa interfaccia. Se questa interfaccia è di un tipo che non supporta ARP, ad esempio PPP, la chiamata ha esito negativo.
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 |
|---|---|
|
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). |
|
Un parametro di input non è valido, non è stata eseguita alcuna azione. Questo errore viene restituito se il parametro dwAddress è zero o un valore non valido, uno degli altri parametri non è valido. |
|
Il trasporto IPv4 non è configurato nel computer locale. |
|
Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito. |
Commenti
Per recuperare la tabella ARP, chiamare la funzione GetIpNetTable . Per eliminare una voce PARP esistente, chiamare DeleteProxyArpEntry.
In Windows Vista e versioni successive la funzione CreateProxyArpEnry può essere chiamata solo da un utente connesso come membro del gruppo Administrators. Se CreateProxyArpEnry viene chiamato da un utente che non è membro del gruppo Administrators, la chiamata di funzione avrà esito negativo e ERROR_ACCESS_DENIED viene restituito. Questa funzione può anche non riuscire a causa del controllo dell'account utente in Windows Vista e versioni successive. Se un'applicazione che contiene 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 impostato su requireAdministrator. Se l'applicazione in Windows Vista e versioni successive non dispone 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) affinché questa funzione abbia esito positivo.
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
Informazioni di riferimento sulle funzioni helper IP