Compartir a través de


Función SetIpNetEntry2 (netioapi.h)

La función SetIpNetEntry2 establece la dirección física de una entrada de dirección IP de vecino existente en el equipo local.

Sintaxis

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API SetIpNetEntry2(
  [in, out] PMIB_IPNET_ROW2 Row
);

Parámetros

[in, out] Row

Puntero a una entrada de estructura de MIB_IPNET_ROW2 para una entrada de dirección IP vecina.

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 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
Se pasó un parámetro no válido a la función. Este error se devuelve si se pasa un puntero NULL en el parámetro Row, el miembro Address del MIB_IPNET_ROW2 al que apunta el parámetro Row no se estableció en una dirección IPv4 o IPv6 de multidifusión válida, los miembros PhysicalAddress y PhysicalAddressLength del MIB_IPNET_ROW2 señalados por el parámetro Row no se establecieron en una dirección física válida, o los miembros InterfaceLuid o InterfaceIndex del MIB_IPNET_ROW2 señalados por el parámetro Row no se especificaron. Este error también se devuelve si se pasó una dirección de bucle invertido en el miembro Address .
ERROR_NOT_FOUND
No se encontró la interfaz especificada. Este error se devuelve si no se encontró la interfaz de red especificada por el miembro InterfaceLuid o InterfaceIndex del MIB_IPNET_ROW2 señalado por el parámetro Row .
ERROR_NOT_SUPPORTED
No se admite la solicitud. Este error se devuelve si no hay ninguna pila IPv4 en el equipo local y se especificó una dirección IPv4 en el miembro Address del MIB_IPNET_ROW2 apuntado por el parámetro Row o ninguna pila IPv6 está en el equipo local y se especificó una dirección IPv6 en el miembro Address .
Otros
Use FormatMessage para obtener la cadena de mensaje para el error devuelto.

Comentarios

La función SetIpNetEntry2 se define en Windows Vista y versiones posteriores.

La función SetIpNetEntry2 se usa para establecer la dirección física de una entrada de dirección IP vecina existente en un equipo local.

El miembro Address de la estructura MIB_IPNET_ROW2 a la que apunta el parámetro Row debe inicializarse en una dirección y familia IPv4 o IPv6 válidas. Los miembros PhysicalAddress y PhysicalAddressLength de la estructura MIB_IPNET_ROW2 a la que apunta el parámetro Row deben inicializarse en una dirección física válida. Además, al menos uno de los siguientes miembros de la estructura MIB_IPNET_ROW2 apunta al parámetro Row debe inicializarse en la interfaz: InterfaceLuid o InterfaceIndex.

Los campos se usan en el orden indicado anteriormente. Por lo tanto, si se especifica InterfaceLuid , este miembro se usa para determinar la interfaz en la que se va a agregar la dirección IP de unidifusión. Si no se estableció ningún valor para el miembro InterfaceLuid (los valores de este miembro se establecieron en cero), el miembro InterfaceIndex se usará a continuación para determinar la interfaz.

Se producirá un error en la función SetIpNetEntry2 si la dirección IP pasada en el miembro Address del MIB_IPNET_ROW2 señalado por el parámetro Row no es una dirección IP vecina existente en la interfaz especificada.

Un usuario que inició sesión como miembro del grupo Administradores solo puede llamar a la función SetIpNetEntry2 . Si un usuario llama a SetIpNetEntry2 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 SetIpNetEntry2 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.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado netioapi.h (include Iphlpapi.h)
Library Iphlpapi.lib
Archivo DLL Iphlpapi.dll

Consulte también

CreateIpNetEntry2

DeleteIpNetEntry2

FlushIpNetTable2

GetIpNetEntry2

GetIpNetTable2

MIB_IPNET_ROW2

MIB_IPNET_TABLE2

ResolveIpNetEntry2