Condividi tramite


Funzione SetIpNetEntry (iphlpapi.h)

La funzione SetIpNetEntry modifica una voce ARP esistente nella tabella ARP nel computer locale.

Sintassi

IPHLPAPI_DLL_LINKAGE DWORD SetIpNetEntry(
  [in] PMIB_IPNETROW pArpEntry
);

Parametri

[in] pArpEntry

Puntatore a una struttura MIB_IPNETROW . Le informazioni contenute in questa struttura specificano la voce da modificare e le nuove informazioni per la voce. Il chiamante deve specificare i valori per tutti i membri di questa struttura.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

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
Il parametro pArpEntry è NULL oppure SetIpNetEntry non è in grado di leggere dalla memoria a cui punta pArpEntry oppure uno dei membri della struttura MIB_IPNETROW non è valido.
ERROR_NOT_SUPPORTED
Il trasporto IPv4 non è configurato nel computer locale.
Altri
Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

Commenti

In Windows Vista e versioni successive la funzione SetIpNetEntry può essere chiamata solo da un utente connesso come membro del gruppo Administrators. Se SetIpNetEntry viene chiamato da un utente che non è membro del gruppo Administrators, la chiamata di funzione avrà esito negativo e ERROR_ACCESS_DENIED viene restituito.

La funzione SetIpNetEntry può avere esito negativo anche 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 non dispone di questo file manifesto, un utente connesso 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.

Nota In Windows NT 4.0 e Windows 2000 e versioni successive questa funzione esegue un'operazione con privilegi. Affinché questa funzione venga eseguita correttamente, il chiamante deve essere connesso come membro del gruppo Administrators o del gruppo NetworkConfigurationOperators.
 

Requisiti

Requisito Valore
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

CreateIpNetEntry

DeleteIpNetEntry

Informazioni di riferimento sulle funzioni helper IP

Pagina iniziale dell'helper IP

MIB_IPNETROW