Función InitializeIpForwardEntry (netioapi.h)

Artículo
02/29/2024

La función InitializeIpForwardEntry inicializa una estructura de MIB_IPFORWARD_ROW2 con valores predeterminados para una entrada de ruta IP en el equipo local.

Sintaxis

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeIpForwardEntry(
  [out] PMIB_IPFORWARD_ROW2 Row
);

Parámetros

[out] Row

En la entrada, un puntero a una entrada de estructura MIB_IPFORWARD_ROW2 para una entrada de ruta IP. A cambio, la estructura de MIB_IPFORWARD_ROW2 a la que apunta este parámetro se inicializa con valores predeterminados para una entrada de ruta IP.

Valor devuelto

Esta función no devuelve ningún valor.

Observaciones

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

La función InitializeIpForwardEntry debe usarse para inicializar los miembros de una entrada de estructura de MIB_IPFORWARD_ROW2 con valores predeterminados para una entrada de ruta IP para su uso posterior con la función CreateIpForwardEntry2 .

En la entrada, InitializeIpForwardEntry debe pasarse una nueva estructura de MIB_IPFORWARD_ROW2 para inicializar.

En la salida, los miembros ValidLifetime y PreferredLifetime de la estructura MIB_IPFORWARD_ROW2 a la que apunta el parámetro Row se inicializarán en infinito y los miembros Loopback, AutoconfigureAddress, Publish e Inmortal se inicializarán en TRUE. Además, los miembros SitePrefixLength, Metric y Protocol se establecen en un valor no válido y otros campos se inicializan en cero.

Después de llamar a InitializeIpForwardEntry, una aplicación puede cambiar los miembros de la entrada MIB_IPFORWARD_ROW2 que desea modificar y, a continuación, llamar a CreateIpForwardEntry2 para agregar la nueva entrada de ruta IP al equipo local.

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 (incluya Iphlpapi.h)
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll