MIB_IPINTERFACE_ROW estrutura

A estrutura MIB_IPINTERFACE_ROW armazena informações de gerenciamento de interface para uma determinada família de endereços IP em uma interface de rede.

Sintaxe

typedef struct _MIB_IPINTERFACE_ROW {
  ADDRESS_FAMILY                 Family;
  NET_LUID                       InterfaceLuid;
  NET_IFINDEX                    InterfaceIndex;
  ULONG                          MaxReassemblySize;
  ULONG64                        InterfaceIdentifier;
  ULONG                          MinRouterAdvertisementInterval;
  ULONG                          MaxRouterAdvertisementInterval;
  BOOLEAN                        AdvertisingEnabled;
  BOOLEAN                        ForwardingEnabled;
  BOOLEAN                        WeakHostSend;
  BOOLEAN                        WeakHostReceive;
  BOOLEAN                        UseAutomaticMetric;
  BOOLEAN                        UseNeighborUnreachabilityDetection;
  BOOLEAN                        ManagedAddressConfigurationSupported;
  BOOLEAN                        OtherStatefulConfigurationSupported;
  BOOLEAN                        AdvertiseDefaultRoute;
  NL_ROUTER_DISCOVERY_BEHAVIOR   RouterDiscoveryBehavior;
  ULONG                          DadTransmits;
  ULONG                          BaseReachableTime;
  ULONG                          RetransmitTime;
  ULONG                          PathMtuDiscoveryTimeout;
  NL_LINK_LOCAL_ADDRESS_BEHAVIOR LinkLocalAddressBehavior;
  ULONG                          LinkLocalAddressTimeout;
  ULONG                          ZoneIndices[ScopeLevelCount];
  ULONG                          SitePrefixLength;
  ULONG                          Metric;
  ULONG                          NlMtu;
  BOOLEAN                        Connected;
  BOOLEAN                        SupportsWakeUpPatterns;
  BOOLEAN                        SupportsNeighborDiscovery;
  BOOLEAN                        SupportsRouterDiscovery;
  ULONG                          ReachableTime;
  NL_INTERFACE_OFFLOAD_ROD       TransmitOffload;
  NL_INTERFACE_OFFLOAD_ROD       ReceiveOffload;
  BOOLEAN                        DisableDefaultRoutes;
} MIB_IPINTERFACE_ROW, *PMIB_IPINTERFACE_ROW;

Membros

para famílias
A família do endereço. Os valores possíveis para a família de endereços estão listados no arquivo de cabeçalho Winsock2.h. Observe que os valores para a família de endereços AF_ e as constantes da família PF_ protocolo são idênticos (por exemplo, AF_INET e PF_INET), portanto, você pode usar qualquer constante.

No Windows Vista e versões posteriores dos sistemas operacionais Windows, os valores possíveis para esse membro são definidos no arquivo de cabeçalho Ws2def.h. Observe que o arquivo de cabeçalho Ws2def.h é incluído automaticamente no Netioapi.h e você nunca deve usar Ws2def.h diretamente.

Os seguintes valores são suportados atualmente:
- AF_INET
  A família de endereços IPv4.
- AF_INET6
  A família de endereços IPv6.
- AF_UNSPEC
  A família de endereços não é especificada.
InterfaceLuid
O identificador exclusivo local (LUID) para a interface de rede.
InterfaceIndex
O valor do índice local para a interface de rede. 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.
MaxReassemblySize
O tamanho máximo de remontagem, em bytes, de um pacote IP fragmentado. Este membro está atualmente definido como zero e reservado para uso futuro.
InterfaceIdentifier
Reservado para uso futuro. Este membro está atualmente definido como zero.
MinRouterAdvertisementInterval
O intervalo mínimo de anúncio do roteador, em milissegundos, nesta interface IP. O padrão desse membro é 200 para IPv6. Este membro só é aplicável se o membro AdvertisingEnabled estiver definido como TRUE.
MaxRouterAdvertisementInterval
O intervalo máximo de anúncio do roteador, em milissegundos, nesta interface IP. O padrão deste membro é 600 para IPv6. Este membro só é aplicável se o membro AdvertisingEnabled estiver definido como TRUE.
AdvertisingEnabled
Um valor que indica se a publicidade do roteador está habilitada nessa interface IP. O padrão para IPv6 é que o anúncio de roteador é habilitado somente se a interface estiver configurada para atuar como um roteador. O padrão para IPv4 é que o anúncio do roteador está desativado.
ForwardingEnabled
Um valor que indica se o encaminhamento IP está habilitado nessa interface IP.
WeakHostSend
Um valor que indica se o modo de envio de host fraco está habilitado nessa interface IP.
WeakHostReceive
Um valor que indica se o modo de recebimento de host fraco está habilitado nessa interface IP.
UseAutomaticMetric
Um valor que indica se a interface IP usa métrica automática.
UseNeighborUnreachabilityDetection
Um valor que indica se a deteção de inacessibilidade do vizinho está habilitada nessa interface IP.
ManagedAddressConfigurationSupported
Um valor que indica se a interface IP suporta a configuração de endereço gerenciado usando DHCP.
OtherStatefulConfigurationSupported
Um valor que indica se a interface IP suporta outra configuração com monitoração de estado (por exemplo, configuração de rota).
AdvertiseDefaultRoute
Um valor que indica se a interface IP anuncia a rota padrão. Este membro só é aplicável se o membro AdvertisingEnabled estiver definido como TRUE.
RouterDiscoveryBehavior
Um tipo de comportamento de descoberta de roteador NL_ROUTER_DISCOVERY_BEHAVIOR.
DadTransmits
O número de mensagens consecutivas que são enviadas enquanto o driver executa a deteção de endereço duplicado em um endereço unicast IP provisório. Um valor zero indica que a deteção de endereços duplicados não é executada em endereços IP provisórios. Um valor de um indica uma única transmissão sem retransmissões subsequentes. Para IPv4, o valor padrão para este membro é 3. Para IPv6, o valor padrão para este membro é 1. Para IPv6, essas mensagens são enviadas como solicitações NS (IPv6 Neighbor Solicitation). Este membro é definido como DupAddrDetectTransmits no RFC 2462. Para obter mais informações, consulte IPv6 "Stateless Address Autoconfiguration".
BaseReachableTime
A base para o tempo aleatório alcançável, em milissegundos. O membro é descrito no RFC 2461. Para obter mais informações, consulte "Neighbor Discovery for IP Version 6 (IPv6)".
RetransmitTime
O tempo limite de solicitação de vizinho (NS) IPv6, em milissegundos. O membro é descrito no RFC 2461. Para obter mais informações, consulte "Neighbor Discovery for IP Version 6 (IPv6)".
PathMtuDiscoveryTimeout
O tempo limite de descoberta de MTU do caminho, em milissegundos.
LinkLocalAddressBehavior
Um tipo de comportamento de endereço local de link NL_LINK_LOCAL_ADDRESS_BEHAVIOR.
LinkLocalAddressTimeout
O tempo limite do endereço IP local do link, em milissegundos.
ZoneIndices
Uma matriz que especifica a parte da zona das IDs de escopo.
SitePrefixLength
O comprimento do prefixo do site, em bits, do endereço de interface IP. O comprimento, em bits, do prefixo do site ou parte da rede do endereço de interface IP. Para um endereço IPv4, qualquer valor maior que 32 é um valor ilegal. Para um endereço IPv6, qualquer valor maior que 128 é um valor ilegal. Um valor de 255 é normalmente usado para representar um valor ilegal.
Métrica
A métrica da interface. Observe que a métrica de rota real usada para calcular a preferência de rota é a soma do deslocamento da métrica de rota especificado no membro Metric da estrutura MIB_IPFORWARD_ROW2 e na métrica de interface especificada nesse membro.
NlMtu
O tamanho da MTU da camada de rede, em bytes.
conectados
Um valor que indica se a interface está conectada a um ponto de acesso de rede.
SuportesWakeUpPatterns
Um valor que especifica se a interface de rede suporta Wake on LAN.
SupportsNeighborDiscovery
Um valor que especifica se a interface IP suporta a descoberta de vizinhos.
SupportsRouterDiscovery
Um valor que especifica se a interface IP suporta a descoberta de vizinhos.
ReachableTime
A base para o tempo aleatório alcançável, em milissegundos. O membro é descrito no RFC 2461. Para obter mais informações, consulte Neighbor Discovery for IP Version 6 (IPv6).
TransmitOffload
Um conjunto de sinalizadores que indicam os recursos de descarregamento de transmissão para a interface IP. A estrutura NL_INTERFACE_OFFLOAD_ROD é definida no arquivo de cabeçalho Nldef.h.
ReceiveOffload
Um conjunto de sinalizadores que indicam os recursos de descarregamento de recebimento para a interface IP. A estrutura NL_INTERFACE_OFFLOAD_ROD é definida no arquivo de cabeçalho Nldef.h.
DisableDefaultRoutes
Um valor que indica se o uso da rota padrão na interface deve ser desabilitado. Os clientes VPN podem usar esse membro para restringir o túnel dividido.

Comentários

O da Família, InterfaceLuide InterfaceIndex membros identificam exclusivamente uma entrada MIB_IPINTERFACE_ROW.

Quando um pacote unicast chega a um host, o IP deve determinar se o pacote é destinado localmente (seu destino corresponde a um endereço atribuído a uma interface do host). As implementações de IP que seguem um modelo de host fraco aceitam qualquer pacote destinado localmente, independentemente da interface na qual o pacote foi recebido. As implementações de IP que seguem o modelo de host forte aceitam apenas pacotes destinados localmente se o endereço de destino no pacote corresponder a um endereço atribuído à interface na qual o pacote foi recebido. O modelo de host fraco fornece melhor conectividade de rede. No entanto, também torna os anfitriões suscetíveis a ataques de rede baseados em várias casas.

A implementação IPv4 atual nos sistemas operacionais Windows Server 2003 e Windows XP usa o modelo de host fraco. A pilha TCP/IP no Windows Vista e versões posteriores dos sistemas operacionais Windows oferece suporte ao modelo de host forte para IPv4 e IPv6 e está configurada para usar o modo de host forte por padrão (o WeakHostReceive e membros do WeakHostSend estão definidos como FALSE). Você pode configurar a pilha TCP/IP no Windows Vista e posterior para usar um modelo de host fraco.

Uma métrica é 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 posterior 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 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.

O recurso de métrica automática pode ser útil quando a tabela de roteamento contém várias rotas para o mesmo destino. Por exemplo, um computador que tem uma interface de rede de 10 megabits e uma interface de rede de 100 megabits tem um gateway padrão que é configurado em ambas as interfaces de rede. Quando UseAutomaticMetric é TRUE, esse recurso pode forçar todo o tráfego destinado à Internet, por exemplo, a usar a interface de rede mais rápida disponível.

A métrica de interface especificada no membro Métrica representa apenas a métrica da interface. A métrica de roteamento completo é uma combinação dessa métrica de interface adicionada ao deslocamento da métrica de rota especificado no membro Métrica de da estrutura MIB_IPFORWARD_ROW2 de uma entrada de rota especificada nessa interface.

O acesso simultâneo não privilegiado a várias redes de diferentes requisitos de segurança cria uma falha de segurança e permite que um driver sem privilégios retransmita acidentalmente dados entre as duas redes. Um exemplo típico é o acesso simultâneo a uma rede virtual privada (VPN) e à Internet. O Windows Server 2003 e o Windows XP usam um modelo de host fraco, em que o Serviço de Acesso Remoto (RAS) impede esse acesso simultâneo aumentando a métrica de rota de todas as rotas padrão em outras interfaces. Portanto, todo o tráfego é roteado através da interface VPN, interrompendo outra conectividade de rede.

No Windows Vista e versões posteriores, por padrão, um modelo de host forte é usado. Se um endereço IP de origem for especificado na pesquisa de rota usando a funçãoGetBestRoute2, a pesquisa de rota será restrita à interface do endereço IP de origem. A modificação da métrica de rota pelo RAS não tem efeito porque a lista de rotas potenciais nem sequer tem a rota para a interface VPN, que permite o tráfego para a Internet. Seu driver pode usar o DisableDefaultRoutes membro da estrutura MIB_IPINTERFACE_ROW para desativar usando a rota padrão em uma interface. Os clientes VPN podem usar esse membro como uma medida de segurança para restringir o túnel dividido quando o túnel dividido não é exigido pelo cliente VPN. Um cliente VPN pode chamar o função SetIpInterfaceEntry para definir o membro DisableDefaultRoutes para TRUE quando necessário. Um cliente VPN pode consultar o estado atual do membro DisableDefaultRoutes chamando a funçãoGetIpInterfaceEntry.