Función CreateIpNetEntry (iphlpapi.h)

Artículo
08/24/2023

La función CreateIpNetEntry crea una entrada del Protocolo de resolución de direcciones (ARP) en la tabla ARP del equipo local.

Sintaxis

IPHLPAPI_DLL_LINKAGE DWORD CreateIpNetEntry(
  [in] PMIB_IPNETROW pArpEntry
);

Parámetros

[in] pArpEntry

Puntero a una estructura MIB_IPNETROW que especifica información para la nueva entrada. El llamador debe especificar valores para todos los miembros de esta estructura.

Valor devuelto

La función devuelve NO_ERROR (cero) si la función se realiza correctamente.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto	Descripción
ERROR_ACCESS_DENIED	Se denegó el acceso. Este error se devuelve en Windows Vista y Windows Server 2008 en varias condiciones que incluyen lo siguiente: el usuario carece de los privilegios administrativos necesarios en el equipo local o la aplicación no se ejecuta en un shell mejorado como administrador integrado (administrador de RunAs).
ERROR_INVALID_PARAMETER	Un parámetro de entrada no es válido, no se realizó ninguna acción. Este error se devuelve si el parámetro pArpEntry es NULL, el miembro dwPhysAddrLen de MIB_IPNETROW se establece en cero o un valor mayor que 8, el >miembro dwAddr de la estructura MIB_IPNETROW no es válido o uno de los demás miembros de la estructura MIB_IPNETROW no es válido.
ERROR_NOT_SUPPORTED	El transporte IPv4 no está configurado en el equipo local.
Otros	Use FormatMessage para obtener la cadena de mensaje del error devuelto.

Comentarios

Para modificar una entrada ARP existente, use la función SetIpNetEntry . Para recuperar la tabla ARP, llame a la función GetIpNetTable . Para eliminar una entrada ARP existente, llame a DeleteIpNetEntry.

En Windows Vista y versiones posteriores, solo un usuario que ha iniciado sesión como miembro del grupo Administradores puede llamar a la función CreateIpNetEntry . Si un usuario llama a CreateIpNetEntry que no es miembro del grupo Administradores, se producirá un error en la llamada de función y se devolverá ERROR_ACCESS_DENIED .

La función CreateIpNetEntry también puede producir un error debido al control de cuentas de usuario (UAC) en Windows Vista más adelante. Si un usuario inicia sesión como miembro del grupo Administradores que no sea el administrador integrado, esta llamada producirá un error a menos que la aplicación se haya marcado en el archivo de manifiesto con un valor requestedExecutionLevel establecido en requireAdministrator. Si la aplicación carece de este archivo de manifiesto, un usuario que inició sesión como miembro del grupo Administradores que no sea el administrador integrado debe ejecutar la aplicación en un shell mejorado como administrador integrado (administrador de RunAs) para que esta función se realice correctamente.

Nota En Windows NT 4.0 y Windows 2000 y versiones posteriores, esta función ejecuta una operación con privilegios. Para que esta función se ejecute correctamente, el autor de la llamada debe iniciar sesión como miembro del grupo Administradores o del grupo NetworkConfigurationOperators.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	iphlpapi.h
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll