Función InitializeIpForwardEntry (netioapi.h)
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 |