estructura de MIB_IPFORWARD_ROW2
La estructura MIB_IPFORWARD_ROW2 almacena información sobre una entrada de ruta IP.
Sintaxis
typedef struct _MIB_IPFORWARD_ROW2 {
NET_LUID InterfaceLuid;
NET_IFINDEX InterfaceIndex;
IP_ADDRESS_PREFIX DestinationPrefix;
SOCKADDR_INET NextHop;
UCHAR SitePrefixLength;
ULONG ValidLifetime;
ULONG PreferredLifetime;
ULONG Metric;
NL_ROUTE_PROTOCOL Protocol;
BOOLEAN Loopback;
BOOLEAN AutoconfigureAddress;
BOOLEAN Publish;
BOOLEAN Immortal;
ULONG Age;
NL_ROUTE_ORIGIN Origin;
} MIB_IPFORWARD_ROW2, *PMIB_IPFORWARD_ROW2;
Miembros
InterfaceLuid
Identificador único local (LUID) de la interfaz de red asociada a esta entrada de ruta IP.InterfaceIndex
Valor de índice local para la interfaz de red asociada a esta entrada de ruta IP. Este valor de índice puede cambiar cuando un adaptador de red está deshabilitado y, a continuación, habilitado, o en otras circunstancias, y no debe considerarse persistente.DestinationPrefix
Prefijo de dirección IP para la dirección IP de destino de esta ruta.NextHop
Para una ruta remota, la dirección IP del siguiente sistema o puerta de enlace que se encuentra a lo largo de la ruta. Si la ruta es a una dirección de bucle invertido local o una dirección IP en el vínculo local, el próximo salto no se especifica (todos los ceros). Para una ruta de bucle invertido local, este miembro debe ser una dirección IPv4 de 0.0.0.0 para una entrada de ruta IPv4 o una dirección IPv6 de 0::0 para una entrada de ruta IPv6.SitePrefixLength
Longitud, en bits, del prefijo de sitio o parte de red de la dirección IP de esta ruta. Para una entrada de ruta IPv4, cualquier valor mayor que 32 es un valor no válido. Para una entrada de ruta IPv6, cualquier valor mayor que 128 es un valor no válido. Normalmente, se usa un valor de 255 para representar un valor no válido.ValidLifetime
El tiempo máximo, en segundos, que la entrada de ruta IP es válida. Un valor de 0xffffffff se considera infinito.PreferredLifetime
El tiempo preferido, en segundos, que la entrada de ruta IP es válida. Un valor de 0xffffffff se considera infinito.Métrica
Valor de desplazamiento de métrica de ruta para esta entrada de ruta IP. Tenga en cuenta que la métrica de ruta real que se usa para calcular la preferencia de ruta es la métrica de interfaz que se especifica en el miembro Métrica de la estructura MIB_IPINTERFACE_ROW agregada al desplazamiento de métrica de ruta especificado en este miembro de métrica de ruta . La semántica de esta métrica viene determinada por el protocolo de enrutamiento especificado en el miembro Protocolo . Si no se usa esta métrica, su valor debe establecerse en -1. Este valor se documenta en RFC 4292. Para obtener más información, consulte IP Forwarding Table MIB.Protocolo
El NL_ROUTE_PROTOCOL tipo de mecanismo de enrutamiento con el que se agregó esta ruta IP.Bucle invertido
Valor que especifica si la ruta es una ruta de bucle invertido (la puerta de enlace está en el host local).Configuración automáticaAddress
Valor que especifica si la dirección IP está configurada automáticamente.Publicar
Valor que especifica si se publica la ruta.Inmortal
Valor que especifica si la ruta es inmortal.Age
Número de segundos desde que se agregó o modificó la ruta en la tabla de enrutamiento de red.Origen
Tipo de origen de ruta IP NL_ROUTE_ORIGIN .
Observaciones
La función GetIpForwardTable2 enumera las entradas de ruta IP en un equipo local y devuelve esta información en una estructura de MIB_IPFORWARD_TABLE2 como una matriz de MIB_IPFORWARD_ROW2 entradas.
La función GetIpForwardEntry2 recupera una única entrada de ruta IP y devuelve esta información en una estructura de MIB_IPFORWARD_ROW2.
Una entrada con los miembros Prefix y PrefixLength de IP_ADDRESS_PREFIX establecido en cero en el miembro DestinationPrefix de la estructura MIB_IPFORWARD_ROW2 se considera una ruta predeterminada. El MIB_IPFORWARD_TABLE2 puede contener varias entradas de MIB_IPFORWARD_ROW2 con los miembros Prefix y PrefixLength del IP_ADDRESS_PREFIX establecido en cero en el miembro DestinationPrefix cuando hay varios adaptadores de red instalados.
El miembro Metric de una entrada de MIB_IPFORWARD_ROW2 es un valor que se asigna a una ruta IP para una interfaz de red determinada que identifica el costo asociado al uso de esa ruta. Por ejemplo, la métrica se puede valorar en términos de velocidad de vínculo, recuento de saltos o retraso de tiempo. La métrica automática es una característica en Windows XP y versiones posteriores de los sistemas operativos Windows que configura automáticamente la métrica para las rutas locales basadas en la velocidad del vínculo. De forma predeterminada, la característica de métrica automática está habilitada (el miembro UseAutomaticMetric de la estructura MIB_IPINTERFACE_ROW se establece en TRUE) en Windows XP y versiones posteriores. También puede configurar manualmente esta característica para asignar una métrica específica a una ruta IP.
La métrica de ruta que se especifica en el miembro Métrica de la estructura MIB_IPFORWARD_ROW2 representa solo el desplazamiento de la métrica de ruta. La métrica completa es una combinación de este desplazamiento de métrica de ruta agregado a la métrica de interfaz que se especifica en el miembro Métrica de la estructura MIB_IPINTERFACE_ROW de la interfaz asociada. Un controlador puede recuperar la métrica de interfaz llamando a la función GetIpInterfaceEntry .
Requisitos
Versión |
Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado |
Netioapi.h (incluya Netioapi.h) |