estrutura MIB_IPFORWARD_ROW2

Artigo
03/08/2023

A estrutura MIB_IPFORWARD_ROW2 armazena informações sobre uma entrada de rota IP.

Sintaxe

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;

Membros

InterfaceLuid
O LUID (identificador exclusivo local) para o adaptador de rede associado a essa entrada de rota IP.
Interfaceindex
O valor do índice local para o adaptador de rede associado a essa entrada de rota IP. Esse valor de índice pode ser alterado quando um adaptador de rede é desabilitado e, em seguida, habilitado ou em outras circunstâncias, e não deve ser considerado persistente.
DestinationPrefix
O prefixo de endereço IP para o endereço IP de destino para essa rota.
NextHop
Para uma rota remota, o endereço IP do próximo sistema ou gateway que está ao longo da rota. Se a rota for para um endereço de loopback local ou um endereço IP no link local, o próximo salto não será especificado (todos os zeros). Para uma rota de loopback local, esse membro deve ser um endereço IPv4 de 0.0.0.0 para uma entrada de rota IPv4 ou um endereço IPv6 de 0::0 para uma entrada de rota IPv6.
SitePrefixLength
O comprimento, em bits, do prefixo do site ou parte da rede do endereço IP dessa rota. Para uma entrada de rota IPv4, qualquer valor maior que 32 é um valor inválido. Para uma entrada de rota IPv6, qualquer valor maior que 128 é um valor inválido. Um valor de 255 normalmente é usado para representar um valor inválido.
ValidLifetime
O tempo máximo, em segundos, em que a entrada de rota IP é válida. Um valor de 0xffffffff é considerado infinito.
PreferredLifetime
O tempo preferencial, em segundos, em que a entrada de rota IP é válida. Um valor de 0xffffffff é considerado infinito.
Métrica
O valor de deslocamento da métrica de rota para essa entrada de rota IP. Observe que a métrica de rota real usada para calcular a preferência de rota é a métrica de interface especificada no membro Métrica da estrutura MIB_IPINTERFACE_ROW adicionada ao deslocamento de métrica de rota especificado neste membro de Métrica . A semântica dessa métrica é determinada pelo protocolo de roteamento especificado no membro Protocolo . Se essa métrica não for usada, seu valor deverá ser definido como -1. Esse valor está documentado no RFC 4292. Para obter mais informações, consulte MIB da tabela de encaminhamento de IP.
Protocolo
O NL_ROUTE_PROTOCOL tipo de mecanismo de roteamento com o qual essa rota IP foi adicionada.
Loopback
Um valor que especifica se a rota é uma rota de loopback (o gateway está no host local).
AutoconfigureAddress
Um valor que especifica se o endereço IP está configurado automaticamente.
Publicar
Um valor que especifica se a rota é publicada.
Imortal
Um valor que especifica se a rota é imortal.
Age
O número de segundos desde que a rota foi adicionada ou modificada na tabela de roteamento de rede.
Origem
Um tipo de origem de rota IP NL_ROUTE_ORIGIN.

Comentários

A função GetIpForwardTable2 enumera as entradas de rota IP em um computador local e retorna essas informações em uma estrutura MIB_IPFORWARD_TABLE2 como uma matriz de entradas MIB_IPFORWARD_ROW2.

A função GetIpForwardEntry2 recupera uma única entrada de rota IP e retorna essas informações em uma estrutura MIB_IPFORWARD_ROW2.

Uma entrada com os membros Prefix e PrefixLength de IP_ADDRESS_PREFIX definida como zero no membro DestinationPrefix na estrutura MIB_IPFORWARD_ROW2 é considerada uma rota padrão. O MIB_IPFORWARD_TABLE2 pode conter várias entradas MIB_IPFORWARD_ROW2 com os membros Prefix e PrefixLength do IP_ADDRESS_PREFIX definido como zero no membro DestinationPrefix quando há vários adaptadores de rede instalados.

O membro Métrica de uma entrada de MIB_IPFORWARD_ROW2 é um valor atribuído a uma rota IP para um adaptador de rede específico que identifica o custo associado ao uso dessa rota. Por exemplo, a métrica pode ser valorizada em termos de velocidade do link, contagem de saltos ou atraso de tempo. A métrica automática é um recurso no Windows XP e versões posteriores dos sistemas operacionais Windows que configuram automaticamente a métrica para as rotas locais baseadas na velocidade do link. Por padrão, o recurso de métrica automática está habilitado (o membro UseAutomaticMetric da estrutura MIB_IPINTERFACE_ROW está definido como TRUE) no Windows XP e posterior. Você também pode configurar manualmente esse recurso para atribuir uma métrica específica a uma rota IP.

A métrica de rota especificada no membro Métrica da estrutura MIB_IPFORWARD_ROW2 representa apenas o deslocamento de métrica de rota. A métrica completa é uma combinação desse deslocamento de métrica de rota adicionado à métrica de interface especificada no membro Métrica da estrutura MIB_IPINTERFACE_ROW da interface associada. Um driver pode recuperar a métrica de interface chamando a função GetIpInterfaceEntry .