Функция GetRTTAndHopCount (iphlpapi.h)

Статья
08/24/2023

Функция GetRTTAndHopCount определяет время кругового пути (RTT) и количество прыжков до указанного места назначения.

Синтаксис

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

Параметры

[in] DestIpAddress

IP-адрес назначения, для которого необходимо определить rtt и число прыжков, в виде структуры IPAddr .

[out] HopCount

Указатель на переменную ULONG . Эта переменная получает число прыжков в место назначения, указанное параметром DestIpAddress .

[in] MaxHops

Максимальное количество прыжков для поиска назначения. Если число прыжков в место назначения превышает это число, функция завершает поиск и возвращает значение FALSE.

[out] RTT

Время кругового пути (в миллисекундах) к месту назначения, заданному параметром DestIpAddress.

Возвращаемое значение

Если функция выполняется успешно, возвращается значение TRUE.

Если функция завершается сбоем, возвращается значение FALSE. Вызовите Метод GetLastError , чтобы получить код ошибки для сбоя.

Сведения о типе данных IPAddr см. в разделе Типы данных Windows. Чтобы преобразовать IP-адрес между точками десятичной нотации и форматом IPAddr , используйте функции inet_addr и inet_ntoa .

Примеры

В следующем примере извлекается и выводится время кругового пути и количество прыжков на IP-адрес назначения 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());
}

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	iphlpapi.h
Библиотека	Iphlpapi.lib
DLL	Iphlpapi.dll