Función SetIpNetEntry (iphlpapi.h)

  • Artículo

La función SetIpNetEntry modifica una entrada ARP existente en la tabla ARP del equipo local.

Sintaxis

IPHLPAPI_DLL_LINKAGE DWORD SetIpNetEntry(
  [in] PMIB_IPNETROW pArpEntry
);

Parámetros

[in] pArpEntry

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

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

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
 Acceso denegado. 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
 El parámetro pArpEntry es NULL o SetIpNetEntry no puede leer de la memoria a la que apunta pArpEntry o uno de los 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 para el error devuelto.

Comentarios

En Windows Vista y versiones posteriores, solo un usuario puede llamar a la función SetIpNetEntry como miembro del grupo Administradores. Si un usuario llama a SetIpNetEntry 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 SetIpNetEntry también puede producir un error debido al control de cuentas de usuario (UAC) en Windows Vista y versiones posteriores. Si un usuario que ha iniciado sesión como miembro del grupo Administradores que no sea el administrador integrado ejecuta esta función, se producirá un error en esta llamada 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 distinto del 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

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

Consulte también

CreateIpNetEntry

DeleteIpNetEntry

Referencia de la función auxiliar de IP

Página de inicio del asistente de IP

MIB_IPNETROW