INFO: API de programa auxiliar IP Adicionar configuração de rede e informações Stat para aplicações Win32

A API de ajuda IP (IPHLPAPI) é um API público que fornece a configuração de rede do Windows e informações estatísticas para aplicações de 32 bits 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 de ajuda IP estão disponíveis para plataformas Windows NT 4.0 e Windows 98.

Este artigo fornece uma breve descrição das API do programa auxiliar de IP disponíveis, agrupados por tarefas que efectuam ou o objecto que elas funcionam nos. Informações adicionais sobre as APIs de ajuda IP, incluindo o código de exemplo, estará disponível a versão do Windows NT 5.0 Beta 2 Platform SDK e posterior.

Classe de interface

Esta classe permite às aplicações obter informações característica de placa de rede. As APIs de programa auxiliar IP disponíveis para o Windows NT 4.0 Service Pack 4 estão listadas abaixo:

• GetIfTable: Obtém todas as características físicas o rede placas.
• GetIfEntry: Obtém as características de adaptador específico.
• SetIfEntry: Actualiza o estado operativo um adaptador específico, como, descrevendo se uma interface é cópia, para baixo ou em modo de teste.
• SetIpTTL: Permite que aplicações para modificar o tempo ao campo restante (TTL) de todos os pacotes IP enviados do sistema.

Classe de endereço IP

Esta classe permite às aplicações modificar e obter informações de configuração de IP. No entanto, a maior parte destas APIs não é suportados no Windows NT 4.0 Service Pack 4. As APIs de programa auxiliar IP disponíveis para o Windows NT 4.0 SP 4 estão listadas abaixo:

• GetIpAddrTable: Permite uma aplicação para obter informações sobre o endereço IP.

Classe de tabela ARP

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

• GetIpNetTable: Obtém informações de tabela de resolução de endereço.
• SetIpNetEntry: Adiciona uma entrada à tabela ARP.
• DeleteIpNetEntry: Elimina uma entrada da tabela ARP.

Classe de tabela de rota

Esta classe permite que aplicações para obter informações de encaminhamento IP e permite que aplicações para efectuar modificações às entradas de rota na tabela. O encaminhamento é a selecção do endereço de salto seguinte de uma tabela encaminhamento através do qual um pacote é enviado. As APIs de programa auxiliar IP disponíveis para o Windows NT 4.0 Service Pack 4 estão listados abaixo:

• GetIpForwardTable: Obtém informações da tabela de encaminhamento.
• SetIpForwardEntry: Adiciona uma entrada de tabela de rota.
• DeleteIpForwardEntry: Elimina uma entrada de tabela de rota.
• Fornece um GetRTTAndHopCount: Viagem circular aproximada 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

Esta classe fornece informações sobre vários tipos de informações de estatísticas de pacotes/ligação num computador local. As APIs de programa auxiliar IP disponíveis para o Windows NT 4.0 Service Pack 4 estão listados abaixo:

• GetIpStatistics: Estatísticas de pacotes IP (protocolo de Internet obtém).
• GetIcmpStatistics: Obtém ICMP Internet Control Message Protocol () estatísticas.
• GetTcpStatistics: Obtém (TCP) estatísticas.
• GetUdpStatistics: Estatísticas de UDP (User Datagram Protocol) do obtém.

Convenções de programa auxiliar IP API

Interfaces são resolvidas pelo índice, que é um grande número DWORD. Para aplicações que esperam interface amigável números (por exemplo, MIB, UI, User Interface), utilize GetFriendlyIndex() para conversão irreversível num índice amigável.

Funções que devolvem uma matriz de estruturas de tomar em tamanho parâmetro pSize /out. O utilizador inicia pSize para apontar para o tamanho da memória intermédia transmitida para a função. Após uma chamada com êxito, este parâmetro mantém o tamanho real dos dados devolvidos. Se a função falhar porque a memória intermédia é demasiado pequena, pSize aponta para o tamanho da memória intermédia necessário para suportar todos os dados disponíveis e a função devolve um estado de erro Win32. A maior parte destas APIs de programa auxiliar IP devolve ERROR_INSUFFICIENT_BUFFER; a excepção é que as GetNetworkParams() e APIs GetAdaptersInfo() devolvem ERROR_BUFFER_OVERFLOW.