MIB_IPFORWARD_ROW2 estrutura

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 identificador exclusivo local (LUID) para a interface de rede associada a essa entrada de rota IP.
InterfaceIndex
O valor de índice local para a interface de rede associada a essa entrada de rota IP. Esse valor de índice pode mudar quando um adaptador de rede é desativado e, em seguida, habilitado, ou em outras circunstâncias, e não deve ser considerado persistente.
DestinationPrefix
O prefixo do endereço IP para o endereço IP de destino para esta 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 para esta rota. Para uma entrada de rota IPv4, qualquer valor maior que 32 é um valor ilegal. Para uma entrada de rota IPv6, qualquer valor maior que 128 é um valor ilegal. Um valor de 255 é normalmente usado para representar um valor ilegal.
ValidLifetime
O tempo máximo, em segundos, que a entrada de rota IP é válida. Um valor de 0xffffffff é considerado infinito.
PreferredLifetime
A hora preferida, 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 na Métrica membro da estrutura MIB_IPINTERFACE_ROW adicionada ao deslocamento da métrica de rota especificado neste membro Métrica. A semântica dessa métrica é determinada pelo protocolo de roteamento especificado no membro do Protocol. Se essa métrica não for usada, seu valor deve ser definido como -1. Esse valor está documentado no RFC 4292. Para obter mais informações, consulte Tabela de Encaminhamento de IP MIB.
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.
Idade
O número de segundos desde que a rota foi adicionada ou modificada na tabela de roteamento de rede.
Origem
Um NL_ROUTE_ORIGIN tipo de origem de rota IP.

Comentários

A funçãoGetIpForwardTable2 doenumera 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 o Prefix e o PrefixLength membros de IP_ADDRESS_PREFIX definidos como zero no membro DestinationPrefix na estrutura MIB_IPFORWARD_ROW2 é considerada uma rota padrão. O MIB_IPFORWARD_TABLE2 pode conter várias entradas de MIB_IPFORWARD_ROW2 com o Prefix e o PrefixLength membros do IP_ADDRESS_PREFIX definido como zero no membro DestinationPrefix quando há vários adaptadores de rede instalados.

A métrica membro de uma entrada MIB_IPFORWARD_ROW2 é um valor atribuído a uma rota IP para uma interface de rede específica que identifica o custo associado ao uso dessa rota. Por exemplo, a métrica pode ser avaliada 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 configura 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 UseAutomaticMetric membro 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 Metric membro da estrutura MIB_IPFORWARD_ROW2 representa apenas o deslocamento da métrica de rota. A métrica completa é uma combinação desse deslocamento da métrica de rota adicionada à métrica de interface especificada na Métrica membro da estrutura MIB_IPINTERFACE_ROW da interface associada. Um driver pode recuperar a métrica da interface chamando a funçãoGetIpInterfaceEntry.