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
);

parameters

[in] DestIpAddress

要确定其 RTT 和跃点计数的目标的 IP 地址，采用 IPAddr 结构的形式。

[out] HopCount

指向 ULONG 变量的指针。此变量接收 DestIpAddress 参数指定的目标的跃点计数。

[in] MaxHops

要搜索目标的最大跃点数。如果目标跃点数超过此数字，函数将终止搜索并返回 FALSE。

[out] RTT

到 DestIpAddress 指定的目标的往返时间（以毫秒为单位）。

返回值

如果函数成功，则返回值为 TRUE。

如果函数失败，则返回值为 FALSE。调用 GetLastError 以获取失败的错误代码。

注解

有关 IPAddr 数据类型的信息，请参阅 Windows 数据类型。若要在点点十进制表示法和 IPAddr 格式之间转换 IP 地址，请使用 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
标头	iphlpapi.h
Library	Iphlpapi.lib
DLL	Iphlpapi.dll