Compartilhar via


Função GetIpStatisticsEx (iphlpapi.h)

A função GetIpStatisticsEx recupera as estatísticas de IP (protocolo IP) do computador atual. A função GetIpStatisticsEx difere da função GetIpStatistics , na qual GetIpStatisticsEx também dá suporte à família de protocolos IPv6 (Internet Protocol versão 6).

Sintaxe

IPHLPAPI_DLL_LINKAGE ULONG GetIpStatisticsEx(
  [out] PMIB_IPSTATS Statistics,
  [in]  ULONG        Family
);

Parâmetros

[out] Statistics

Um ponteiro para uma estrutura MIB_IPSTATS que recebe as estatísticas de IP para o computador local.

[in] Family

A família de protocolos para a qual recuperar estatísticas. Esse parâmetro deve ser um dos seguintes valores:

Valor Significado
AF_INET
Protocolo internet versão 4 (IPv4).
AF_INET6
IPv6 (protocolo IP versão 6).

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos códigos de erro a seguir.

Código de retorno Descrição
ERROR_INVALID_PARAMETER
O parâmetro pStats é NULL ou não aponta para memória válida ou o parâmetro dwFamily não é um valor válido.
ERROR_NOT_SUPPORTED
Não há suporte para essa função no sistema operacional no qual a chamada de função foi feita.
Outros
Use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Comentários

O GetIpStatisticsEx pode ser usado para obter as estatísticas de IP para IPv4 ou IPv6 no computador local.

A função GetIpStatistics retorna as estatísticas somente para IPv4 no computador local.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho iphlpapi.h
Biblioteca Iphlpapi.lib
DLL Iphlpapi.dll

Confira também

GetIpStatistics

GetTcpStatisticsEx

GetUdpStatisticsEx

Referência de função auxiliar de IP

Página Inicial do Auxiliar de IP

MIB_IPSTATS