Funzione CreateIpNetEntry (iphlpapi.h)

Articolo
08/24/2023

La funzione CreateIpNetEntry crea una voce Address Resolution Protocol (ARP) nella tabella ARP nel computer locale.

Sintassi

IPHLPAPI_DLL_LINKAGE DWORD CreateIpNetEntry(
  [in] PMIB_IPNETROW pArpEntry
);

Parametri

[in] pArpEntry

Puntatore a una struttura MIB_IPNETROW che specifica informazioni per la nuova voce. Il chiamante deve specificare i valori per tutti i membri di questa struttura.

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. Questo errore viene restituito se il parametro pArpEntry è NULL, il membro dwPhysAddrLen di MIB_IPNETROW è impostato su zero o un valore maggiore di 8, il >membro dwAddrdella strutturaMIB_IPNETROW non è valido o uno degli altri 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 di messaggio per l'errore restituito.

Commenti

Per modificare una voce ARP esistente, usare la funzione SetIpNetEntry . Per recuperare la tabella ARP, chiamare la funzione GetIpNetTable . Per eliminare una voce ARP esistente, chiamare DeleteIpNetEntry.

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

La funzione CreateIpNetEntry può anche non riuscire a causa del controllo dell'account utente in Windows Vista in un secondo momento. 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.

Nota In Windows NT 4.0 e Windows 2000 e versioni successive, 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