INFO: APIs auxiliares de IP adicionar net Config e informações Stat para aplicativos Win32

O IP Helper API (IPHLPAPI) é uma API pública que fornece informações de estatísticas para aplicativos de 32 bits do Windows e configuração de rede do Windows. A API está disponível para o Windows NT 4.0 Service Pack 4 e posterior e para o Windows 98 e Windows 2000. Nem todas as APIs auxiliares de IP estão disponíveis para plataformas Windows NT 4.0 e Windows 98.

Este artigo fornece uma breve descrição das APIs do auxiliar de IP disponível, agrupadas por tarefa que eles executam ou o objeto operam no. Informações adicionais para as APIs auxiliares de IP, incluindo código de exemplo, estarão disponíveis na versão SDK de plataforma do Windows NT 5.0 Beta 2 e posterior.

Classe de interface

Essa classe permite que aplicativos recuperar informações de característica do adaptador de rede. As APIs auxiliares de IP disponíveis para o Windows NT 4.0 Service Pack 4 estão listadas abaixo:

• GetIfTable: Recupera todos os adaptadores de rede física características.
• GetIfEntry: Recupera as características de adaptador específico.
• SetIfEntry: Atualiza o status operacional de um adaptador específico, como que descreve se uma interface está backup, para baixo ou em um modo de teste.
• SetIpTTL: Permite que aplicativos modificar o tempo de vida (TTL) de campo para todos os pacotes IP enviados do seu sistema.

Classe de endereço IP

Essa classe permite que aplicativos modificar e recuperar informações de configuração de IP. No entanto, a maioria dessas APIs não há suporte para no Windows NT 4.0 Service Pack 4. As APIs auxiliares de IP disponíveis para Windows NT 4.0 SP 4 estão listadas abaixo:

• GetIpAddrTable: Permite que um aplicativo para recuperar informações de endereço IP.

Classe de tabela ARP

Essa classe fornece acesso às entradas de protocolo (ARP) de resolução de endereços por mapeamento de um endereço IP para um endereço físico. As APIs auxiliares de IP disponíveis para o Windows NT 4.0 Service Pack 4 estão listadas abaixo:

• GetIpNetTable: Recupera informações de tabela de resolução de endereço.
• SetIpNetEntry: Adiciona a entrada à tabela ARP.
• DeleteIpNetEntry: Exclui a entrada da tabela ARP.

Classe de tabela de rota

Essa classe permite que aplicativos para recuperar informações de roteamento IP e permite que os aplicativos fazer modificações em entradas de rota na tabela. O roteamento é a seleção do próximo salto Endereço uma tabela de roteamento através do qual um pacote é enviado. As APIs auxiliares de IP disponíveis para Windows NT 4.0 Service Pack 4 estão listados abaixo:

• GetIpForwardTable: Recupera informações da tabela de roteamento.
• SetIpForwardEntry: Adiciona uma entrada de tabela de rota.
• DeleteIpForwardEntry: Exclui uma entrada de rota da tabela.
• Fornece GetRTTAndHopCount: Aproximadas circular vez informações de tempo para um destino de IP específico e também fornece a contagem de saltos para esse destino.

Classe de estatísticas

Essa classe fornece informações em vários tipos de informações de estatísticas de pacote/conexão em um computador local. As APIs auxiliares de IP disponíveis para o Windows NT 4.0 Service Pack 4 estão listados abaixo:

• GetIpStatistics: Estatísticas de pacote recuperações Internet Protocol (IP).
• ICMP (GetIcmpStatistics: Recuperações Internet Control Message Protocol) estatísticas.
• TCP (Transmission Control Protocol) GetTcpStatistics: Recuperações estatísticas.
• GetUdpStatistics: Estatísticas de UDP (User Datagram Protocol) recuperações.

Convenções de IP Helper API

Interfaces são endereçados pelo índice, que é um grande número DWORD. Para aplicativos que esperam interface amigável números (por exemplo, MIB, interface do usuário), use GetFriendlyIndex() para conversão unidirecional em índice amigável.

Funções que retornam uma matriz de estruturas levar in/out pSize de parâmetro de tamanho. O usuário inicializa pSize para que ele aponta para o tamanho do buffer passado para a função. Após uma chamada bem-sucedida, este parâmetro contém o tamanho real dos dados retornados. Se a função falhará porque o buffer é muito pequeno, pSize aponta para o tamanho do buffer necessário para armazenar todos os dados disponíveis e a função retorna um status de erro Win32. A maioria dessas APIs auxiliares de IP retorna ERROR_INSUFFICIENT_BUFFER; a exceção é que as APIs GetAdaptersInfo() e GetNetworkParams() retornam ERROR_BUFFER_OVERFLOW.