Función SetIpNetEntry2

Artículo
03/08/2023

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

Sintaxis

NETIOAPI_API SetIpNetEntry2(
  _In_ PMIB_IPNET_ROW2 Row
);

Parámetros

Fila [in]
Puntero a una entrada de estructura MIB_IPNET_ROW2 para una entrada de dirección IP vecina.

Valor devuelto

SetIpNetEntry2 devuelve STATUS_SUCCESS si la función se realiza correctamente.

Si se produce un error en la función, SetIpNetEntry2 devuelve uno de los siguientes códigos de error:

Código devuelto	Descripción
STATUS_INVALID_PARAMETER	Se pasó un parámetro no válido a la función. Este error se devuelve en las situaciones siguientes. Se pasó un puntero NULL en el parámetro Row . El miembro Address de la estructura MIB_IPNET_ROW2 a la que apunta el parámetro Row no se estableció en una dirección IPv4 o IPv6 válida de unidifusión o multidifusión. Los miembros PhysicalAddress y PhysicalAddressLength de la estructura MIB_IPNET_ROW2 no se establecieron en una dirección física válida. Los miembros InterfaceLuid e InterfaceIndex de la estructura MIB_IPNET_ROW2 no se especificaron. Se pasó una dirección de bucle invertido en el miembro Address .
STATUS_NOT_FOUND	No se encontró la interfaz especificada. Este error se devuelve si la función no encuentra la interfaz de red especificada por el miembro InterfaceLuid o InterfaceIndex de la estructura MIB_IPNET_ROW2 a la que apunta el parámetro Row .
STATUS_NOT_SUPPORTED	No se admite la solicitud. Este error se devuelve si no se encuentra ninguna pila IPv4 en el equipo local y se especificó una dirección IPv4 en el miembro Address de la estructura MIB_IPNET_ROW2 a la que apunta el parámetro Row , o si no se encuentra ninguna pila IPv6 en el equipo local y se especificó una dirección IPv6 en el miembro Address .
Otros	Use la función FormatMessage para obtener la cadena de mensaje del error devuelto.

Observaciones

El controlador debe inicializar los siguientes miembros de la estructura MIB_IPNET_ROW2 a los que apunta el parámetro Row .

Dirección
Establézcalo en una dirección y familia IPv4 o IPv6 válida, cualquier difusión o multidifusión.
PhysicalAddress y PhysicalAddressLength
Establézcalo en una dirección física válida.
InterfaceLuid o InterfaceIndex
Estos miembros se usan en el orden que se muestra anteriormente. Por lo tanto, si se especifica InterfaceLuid , este miembro se usa para determinar la interfaz. Si no se estableció ningún valor para el miembro InterfaceLuid (el valor de este miembro se estableció en cero), el miembro InterfaceIndex se usa a continuación para determinar la interfaz.

Se produce un error en la función SetIpNetEntry2 si la dirección IP que se pasa en el miembro Address de la estructura MIB_IPNET_ROW2 a la que apunta el parámetro Row no es una dirección IP vecina existente en la interfaz especificada.

Requisitos

Plataforma de destino	Universal
Versión	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Encabezado	Netioapi.h (incluya Netioapi.h)
Biblioteca	Netio.lib
IRQL	< DISPATCH_LEVEL