Visão geral do Auxiliar de IP

Artigo
07/08/2024

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

Muitas das funções auxiliares de IP passam parâmetros de estrutura que representam tipos de dados associados à tecnologia MIB (Base de Informações de Gerenciamento). As funções do 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 enlace de dados.

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

O driver pode usar as seguintes funções de modo kernel, estruturas MIB e enumerações MIB e NL (Camada de Rede) para recuperar e modificar as definições de configuração para transporte TCP/IP (Protocolo de Controle de Transmissão) em um computador local.

Observação

Ao desenvolver o código do driver, siga as instruções para incluir arquivos de cabeçalho.

Funções de conversão de interface

Função	Descrição
ConvertInterfaceAliasToLuid	Converte um identificador exclusivo local (LUID) para uma interface de rede no nome da interface Unicode.
ConvertInterfaceGuidToLuid	Converte um GUID (identificador global exclusivo) de um adaptador de rede no LUID da interface.
ConvertInterfaceIndexToLuid	Converte um índice local de uma interface de rede no LUID da interface.
ConvertInterfaceLuidToAlias	Converte um LUID de uma interface de rede em um alias de interface.
ConvertInterfaceLuidToGuid	Converte um LUID para um adaptador de rede em um GUID para a interface.
ConvertInterfaceLuidToIndex	Converte um LUID para uma interface de rede no índice local da interface.
ConvertInterfaceLuidToNameA	Converte um LUID para uma interface de rede para o nome da interface ANSI.
ConvertInterfaceLuidToNameW	Converte um LUID de uma interface de rede para o nome da interface Unicode.
ConvertInterfaceNameToLuidA	Converte um nome de interface de rede ANSI no LUID da interface.
ConvertInterfaceNameToLuidW	Converte um nome de interface de rede Unicode no 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 entradas de linha de pilha de interface de rede que especificam a relação das interfaces de rede em uma 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ções de interface a serem recuperadas.
GetInvertedIfStackTable	Recupera uma tabela de entradas de linha de pilha de interface de rede invertida que especificam a relação das interfaces de rede em uma pilha de interface.
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ços IP

Função	Descrição
CreateAnycastIpAddressEntry	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 de comunicação preferencial.
CreateUnicastIpAddressEntry	Adiciona uma nova entrada de endereço IP unicast no computador local.
ExcluirAnycastIpAddressEntry	Exclui uma entrada de endereço IP anycast existente no computador local.
ExcluirUnicastIpAddressEntry	Exclui uma entrada de endereço IP unicast existente do computador local.
GetAnycastIpAddressEntry	Recupera informações de uma entrada de endereço IP anycast existente no computador local.
GetAnycastIpAddressTable	Recupera a tabela de endereços IP anycast no computador local.
GetMulticastIpAddressEntry	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 de 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ços de vizinho IP

Função	Descrição
CreateIpNetEntry2	Cria uma nova entrada de endereço IP vizinho no computador local.
ExcluirIpNetEntry2	Exclui uma entrada de endereço IP vizinho do computador local.
FlushIpNetTable2	Libera a tabela de vizinhos de IP no computador local.
GetIpNetEntry2	Recupera informações de uma entrada de endereço IP vizinho no computador local.
GetIpNetTable2	Recupera a tabela de IP vizinho 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 de IP

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

Funções de gerenciamento de rotas de IP

Função	Descrição
CreateIpForwardEntry2	Cria uma nova entrada de rota IP no computador local.
ExcluirIpForwardEntry2	Exclui uma entrada de rota IP do computador local.
GetBestRoute2	Recupera a entrada da rota IP no computador local para obter a melhor rota para o endereço IP de destino especificado.
GetIpForwardEntry2	Recupera informações para 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 tabelas de IP

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

Funções Notification

Função	Descrição
CancelMibChangeNotify2	Cancela o registro do driver para notificações de alteração para alterações de 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 a ser notificado sobre alterações em todas as interfaces IP, interfaces IPv4 ou interfaces IPv6 em um computador local.
NotifyRouteChange2	Registra-se a ser notificado sobre alterações nas entradas de rota IP em um computador local.
NotifyUnicastIpAddressChange	Registra-se a ser notificado sobre alterações em todas as interfaces IP unicast, endereços IPv4 unicast ou endereços IPv6 unicast em um 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 a ser notificado sobre alterações no número da porta UDP que o cliente Teredo usa para a porta de serviço Teredo em um computador local.
NotifyStableUnicastIpAddressTable	Recupera a tabela de endereços IP unicast estável em um computador local.

Estruturas do 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ço IP 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 linha na pilha de interface de rede. Esta tabela especifica a relação das interfaces de rede em uma pilha de interface.
MIB_INVERTEDIFSTACK_ROW	Representa a relação entre duas interfaces de rede.
MIB_INVERTEDIFSTACK_TABLE	Contém uma tabela de entradas de linha de pilha de interface de rede invertida. Esta tabela especifica a relação das interfaces de rede em uma pilha de interface 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 família de endereços IP específica em uma interface de rede.
MIB_IPINTERFACE_TABLE	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 de 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 de 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 detecçã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 no 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 no RFC 4292.
NL_ROUTER_DISCOVERY_BEHAVIOR	Define o comportamento de descoberta do roteador, conforme descrito no RFC 2461.
NL_SUFFIX_ORIGIN	Define a origem do sufixo ou parte do host do endereço IP.

Compartilhar via