Compartir a través de


Función InitializeIpForwardEntry

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

Sintaxis

VOID NETIOAPI_API_ InitializeIpForwardEntry(
  _Out_ PMIB_IPFORWARD_ROW2 Row
);

Parámetros

  • Fila [salida]
    En la entrada, un puntero a una entrada de estructura MIB_IPFORWARD_ROW2 para una entrada de ruta IP.

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

Valor devuelto

None

Observaciones

El controlador debe usar la función InitializeIpForwardEntry 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, el controlador debe pasar InitializeIpForwardEntry una nueva estructura de MIB_IPFORWARD_ROW2 para inicializar.

En la salida, los miembros de la estructura MIB_IPFORWARD_ROW2 a los que apunta el parámetro Row se inicializan de la siguiente manera.

  • ValidLifetime y PreferredLifetime
    Se establece en un valor infinito,

  • Bucle invertido, AutoconfiguraciónAddress, Publicación e Inmortal
    Establézcalo en TRUE.

  • SitePrefixLength, Métrica y Protocolo
    Establézcalo en valores no válidos.

  • Todos los demás miembros
    Establecer en cero.

Después de que un controlador llame a InitializeIpForwardEntry, el controlador 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

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

Consulte también

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

SetIpForwardEntry2