Visão geral do IP Helper

Internet Protocol Helper (IP Helper) permite que os drivers recuperem informações sobre a configuração de rede do computador local e modifiquem essa configuração. IP Helper também fornece mecanismos de notificação para garantir que um driver seja notificado quando certos aspetos da configuração da rede do computador local forem alterados. IP Helper está disponível no Windows Vista e versões posteriores dos sistemas operacionais Microsoft Windows.

Muitas das funções IP Helper passam parâmetros de estrutura que representam tipos de dados associados à tecnologia Management Information Base (MIB). As funções IP Helper usam essas estruturas MIB para representar várias informações de rede.

A documentação do IP Helper usa os termos adaptador e interface extensivamente. Um adaptador é um termo herdado que é uma forma abreviada de adaptador de rede, que originalmente se referia a alguma forma de hardware de rede. Um adaptador é uma abstração no nível do link de dados.

Uma interface é descrita nos documentos RFC do IETF como um conceito abstrato que representa a ligação de um nó a um link. Uma interface é uma abstração no nível de IP.

O seu driver pode usar as seguintes funções de modo kernel, estruturas MIB e enumerações MIB e camada de rede (NL) para recuperar e modificar definições de configuração para transporte TCP/IP num computador local.

Observação

Ao desenvolver código de driver, siga as instruções para , incluindo ficheiros de cabeçalho.

Funções de conversão de interface

Função	Descrição
ConvertirAliasDeInterfaceParaLuid	Converte um identificador exclusivo local (LUID) de uma interface de rede para o nome da interface Unicode.
ConvertInterfaceGuidToLuid	Converte um identificador globalmente único (GUID) de uma interface de rede para o LUID correspondente.
ConvertInterfaceIndexToLuid	Converte um índice local de uma interface de rede num LUID para a interface.
ConvertInterfaceLuidParaAlias	Converte um LUID para uma interface de rede em um alias de interface.
ConvertInterfaceLuidToGuid	Converte um LUID para uma interface de rede em um GUID para a interface.
ConvertInterfaceLuidToIndex	Converte um LUID de uma interface de rede ao índice local da interface.
ConvertInterfaceLuidToNameA	Converte um LUID de uma interface de rede para o nome de interface ANSI.
ConvertInterfaceLuidToNameW	Converte um LUID de uma interface de rede para o nome Unicode da interface.
ConvertInterfaceNameToLuidA	Converte um nome de interface de rede ANSI para o LUID da interface.
ConvertInterfaceNameToLuidW	Converte um nome de interface de rede Unicode para o LUID da interface.
if_indextoname	Converte o índice local de uma interface de rede para o nome da interface ANSI.
if_nametoindex	Converte o nome da interface ANSI de uma interface de rede no índice local da interface.

Funções de gerenciamento de interface

Função	Descrição
GetIfEntry2	Recupera informações para a interface especificada no computador local.
GetIfStackTable	Recupera uma tabela de linhas da pilha de interfaces de rede que especificam a relação entre as interfaces de rede numa pilha de interface.
GetIfTable2	Recupera a tabela de interface MIB-II.
GetIfTable2Ex	Recupera a tabela de interface MIB-II, dado um nível de informação de interface a recuperar.
GetInvertedIfStackTable	Recupera uma tabela de entradas da pilha invertida das interfaces de rede que especificam a relação das interfaces de rede em uma pilha de interfaces.
GetIpInterfaceEntry	Recupera informações de IP para a interface especificada no computador local.
GetIpInterfaceTable	Recupera as entradas da interface IP no computador local.
InitializeIpInterfaceEntry	Inicializa os membros de uma entrada de estrutura MIB_IPINTERFACE_ROW com valores padrão.
SetIpInterfaceEntry	Define as propriedades de uma interface IP no computador local.

Funções de gerenciamento de endereço IP

Função	Descrição
CriarEntradaDeEnderecoIpAnycast	Adiciona uma nova entrada de endereço IP anycast no computador local.
CreateSortedAddressPairs	Emparelha uma lista fornecida de endereços de destino com os endereços IP locais da máquina host e classifica os pares de acordo com a ordem preferencial de comunicação.
CriarEntradaDeEndereçoIpUnicast	Adiciona uma nova entrada de endereço IP unicast no computador local.
EliminarEntradaDeEndereçoIpAnycast	Exclui uma entrada de endereço IP anycast existente do computador local.
DeleteUnicastIpAddressEntry	Exclui uma entrada de endereço IP unicast existente do computador local.
GetAnycastIpAddressEntry	Recupera informações de uma entrada de endereço IP de anycast existente no computador local.
GetAnycastIpAddressTable	Recupera a tabela de endereços IP anycast no computador local.
ObterEntradaDeEndereçoIpMulticast	Recupera informações de uma entrada de endereço IP multicast existente no computador local.
GetMulticastIpAddressTable	Recupera a tabela de endereços IP multicast no computador local.
GetUnicastIpAddressEntry	Recupera informações para uma entrada de endereço IP unicast existente no computador local.
GetUnicastIpAddressTable	Recupera a tabela de endereços IP unicast no computador local.
InitializeUnicastIpAddressEntry	Inicializa uma estrutura MIB_UNICASTIPADDRESS_ROW com valores padrão para uma entrada de endereço IP unicast no computador local.
NotifyStableUnicastIpAddressTable	Recupera a tabela de endereços IP unicast estável em um computador local.
SetUnicastIpAddressEntry	Define as propriedades de uma entrada de endereço IP unicast existente no computador local.

Funções de gerenciamento de endereço vizinho IP

Função	Descrição
CreateIpNetEntry2	Cria uma nova entrada de endereço IP vizinho no computador local.
DeleteIpNetEntry2	Exclui uma entrada de endereço IP vizinho do computador local.
FlushIpNetTable2	Limpa a tabela de vizinhos IP no computador local.
GetIpNetEntry2	Recupera informações para uma entrada de endereço IP vizinho no computador local.
GetIpNetTable2	Recupera a tabela vizinha de IP no computador local.
ResolveIpNetEntry2	Resolve o endereço físico de uma entrada de endereço IP vizinho no computador local.
SetIpNetEntry2	Define o endereço físico de uma entrada de endereço IP vizinho existente no computador local.

Funções de gerenciamento de caminho IP

Função	Descrição
FlushIpPathTable	Limpa a tabela de rotas IP no computador local.
GetIpPathEntry	Recupera informações para uma entrada de caminho IP no computador local.
GetIpPathTable	Recupera informações para uma tabela de caminho IP no computador local.

Funções de gerenciamento de rotas IP

Função	Descrição
CreateIpForwardEntry2	Cria uma nova entrada de rota IP no computador local.
DeleteIpForwardEntry2	Exclui uma entrada de rota IP do computador local.
GetBestRoute2	Recupera a entrada de rota IP no computador local para a melhor rota para o endereço IP de destino especificado.
GetIpForwardEntry2	Recupera informações sobre uma entrada de rota IP no computador local.
GetIpForwardTable2	Recupera as entradas de rota IP no computador local.
InitializeIpForwardEntry	Inicializa uma estrutura MIB_IPFORWARD_ROW2 com valores padrão para uma entrada de rota IP no computador local.
SetIpForwardEntry2	Define as propriedades de uma entrada de rota IP no computador local.

Funções de gerenciamento de memória de tabela IP

Função	Descrição
FreeMibTable	Libera o buffer alocado pelas funções que retornam tabelas de interfaces de rede, endereços e rotas (por exemplo, GetIfTable2 e GetAnycastIpAddressTable).

Funções de notificação

Função	Descrição
CancelMibChangeNotify2	Anula o registo do driver para notificações de alterações na interface IP, alterações de endereço IP, alterações de rota IP e solicitações para recuperar a tabela de endereços IP unicast estável.
NotifyIpInterfaceChange	Registra o driver para ser notificado sobre alterações em todas as interfaces IP, IPv4 ou IPv6 num computador local.
NotifyRouteChange2	Regista-se para ser notificado sobre alterações nas entradas de rota IP num computador local.
NotificarAlteraçãoDeEndereçoIpUnicast	Registar-se para receber notificações sobre alterações em todas as interfaces IP unicast, endereços IPv4 unicast ou endereços IPv6 unicast num computador local.

Funções de gerenciamento de cliente IPv6 Teredo

Função	Descrição
GetTeredoPort	Recupera o número da porta UDP dinâmica que o cliente Teredo usa no computador local.
NotifyTeredoPortChange	Registra-se para ser notificado para alterações no número da porta UDP que o cliente Teredo usa para a porta de serviço Teredo em um computador local.
NotificarTabelaDeEndereçosIpUnicastEstáveis	Recupera a tabela de endereços IP unicast estável em um computador local.

Estruturas MIB

Estrutura	Descrição
IP_ADDRESS_PREFIX	Armazena um prefixo de endereço IP.
MIB_ANYCASTIPADDRESS_ROW	Armazena informações sobre um endereço IP anycast.
MIB_ANYCASTIPADDRESS_TABLE	Contém uma tabela de entradas de endereços IP de anycast.
MIB_IF_ROW2	Armazena informações sobre uma interface específica.
MIB_IF_TABLE2	Contém uma tabela de entradas de interface lógica e física.
MIB_IFSTACK_ROW	Representa a relação entre duas interfaces de rede.
MIB_IFSTACK_TABLE	Contém uma tabela de entradas de linhas na pilha de interface de rede. Esta tabela especifica a relação das interfaces de rede em uma pilha de interfaces.
MIB_INVERTEDIFSTACK_ROW	Representa a relação entre duas interfaces de rede.
MIB_INVERTEDIFSTACK_TABLE	Contém uma tabela de entradas de linha invertidas da pilha de interfaces de rede. Esta tabela especifica a relação das interfaces de rede numa pilha de interfaces em ordem inversa.
MIB_IPFORWARD_ROW2	Armazena informações sobre uma entrada de rota IP.
MIB_IPFORWARD_TABLE2	Contém uma tabela de entradas de rota IP.
MIB_IPINTERFACE_ROW	Armazena informações de gerenciamento de interface para uma determinada família de endereços IP em uma interface de rede.
TABELA_DE_INTERFACE_IP_MIB	Contém uma tabela de entradas de interface IP.
MIB_IPNET_ROW2	Armazena informações sobre um endereço IP vizinho.
MIB_IPNET_TABLE2	Contém uma tabela de entradas de endereço IP vizinho.
MIB_IPPATH_ROW	Armazena informações sobre uma entrada de caminho IP.
MIB_IPPATH_TABLE	Contém uma tabela de entradas de caminho IP.
MIB_MULTICASTIPADDRESS_ROW	Armazena informações sobre um endereço IP multicast.
MIB_MULTICASTIPADDRESS_TABLE	Contém uma tabela de entradas de endereço IP multicast.
MIB_UNICASTIPADDRESS_ROW	Armazena informações sobre um endereço IP unicast.
MIB_UNICASTIPADDRESS_TABLE	Contém uma tabela de entradas de endereço IP unicast.

Enumerações MIB

Enumeração	Descrição
MIB_IF_TABLE_LEVEL	Define o nível de informações da interface a serem recuperadas.
MIB_NOTIFICATION_TYPE	Define o tipo de notificação que é passado para uma função de retorno de chamada quando ocorre uma notificação.

Enumerações NL

Enumeração	Descrição
NL_ADDRESS_TYPE	Especifica o tipo de endereço IP da camada de rede.
NL_DAD_STATE	Define o estado de deteção de endereço duplicado (DAD).
NL_LINK_LOCAL_ADDRESS_BEHAVIOR	Define o comportamento do endereço local do link.
NL_NEIGHBOR_STATE	Define o estado de um endereço IP vizinho da camada de rede, conforme descrito na RFC 2461, seção 7.3.2.
NL_PREFIX_ORIGIN	Define a origem do prefixo ou parte de rede do endereço IP.
NL_ROUTE_ORIGIN	Define a origem da rota IP.
NL_ROUTE_PROTOCOL	Define o mecanismo de roteamento com o qual uma rota IP foi adicionada, conforme descrito na RFC 4292.
NL_ROUTER_DISCOVERY_BEHAVIOR	Define o comportamento de descoberta do roteador, conforme descrito na RFC 2461.
NL_SUFFIX_ORIGIN	Define a origem do sufixo ou parte do host do endereço IP.