getRTTAndHopCount 函数 (iphlpapi.h)
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 |