Función InitializeIpForwardEntry

La función InitializeIpForwardEntry inicializa una estructura 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 [out]
  En la entrada, un puntero a una entrada de estructura de 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

Ninguno

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ónCreateIpForwardEntry2 de.

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 de MIB_IPFORWARD_ROW2 a los que apunta el parámetro row se inicializan de la manera siguiente.

• ValidLifetime y PreferredLifetime
  Establézcalo en un valor infinito,

• Loopback, AutoconfigureAddress, Publishy Inmortal
  Establezca en TRUE.

• SitePrefixLength, Metricy Protocol
  Establézcalo en valores no válidos.

• Todos los demás miembros
  Establézcalo en cero.

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

Requisitos

Consulte también

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

SetIpForwardEntry2