Função GetRTTAndHopCount (iphlpapi.h)

Artigo
08/24/2023

A função GetRTTAndHopCount determina o RTT (tempo de viagem de ida e volta) e a contagem de saltos para o destino especificado.

Sintaxe

IPHLPAPI_DLL_LINKAGE BOOL GetRTTAndHopCount(
  [in]  IPAddr DestIpAddress,
  [out] PULONG HopCount,
  [in]  ULONG  MaxHops,
  [out] PULONG RTT
);

Parâmetros

[in] DestIpAddress

Endereço IP do destino para o qual determinar o RTT e a contagem de saltos, na forma de uma estrutura IPAddr .

[out] HopCount

Ponteiro para uma variável ULONG . Essa variável recebe a contagem de saltos para o destino especificado pelo parâmetro DestIpAddress .

[in] MaxHops

Número máximo de saltos para pesquisar o destino. Se o número de saltos para o destino exceder esse número, a função encerrará a pesquisa e retornará FALSE.

[out] RTT

Tempo de viagem de ida e volta, em milissegundos, para o destino especificado por DestIpAddress.

Valor retornado

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

Se a função falhar, o valor retornado será FALSE. Chame GetLastError para obter o código de erro para a falha.

Comentários

Para obter informações sobre o tipo de dados IPAddr , consulte Tipos de dados do Windows. Para converter um endereço IP entre a notação decimal pontilhada e o formato IPAddr , use as funções inet_addr e inet_ntoa .

Exemplos

O exemplo a seguir recupera e imprime o tempo de viagem de ida e volta e a contagem de saltos para o endereço IP de destino 127.0.0.1.

UINT ip = inet_addr("127.0.0.1");
ULONG hopCount = 0;
ULONG RTT = 0;

if(GetRTTAndHopCount(ip, &hopCount, 30, &RTT) == TRUE) {
  printf("Hops: %ld\n", hopCount);
  printf("RTT: %ld\n", RTT);
}
else {
  printf("Error: %ld\n", GetLastError());
}

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	iphlpapi.h
Biblioteca	Iphlpapi.lib
DLL	Iphlpapi.dll