getRTTAndHopCount 函式 (iphlpapi.h)
GetRTTAndHopCount函式會決定 (RTT) 和躍點計數到指定目的地的來回時間。
語法
IPHLPAPI_DLL_LINKAGE BOOL GetRTTAndHopCount(
[in] IPAddr DestIpAddress,
[out] PULONG HopCount,
[in] ULONG MaxHops,
[out] PULONG RTT
);
參數
[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 |
| 程式庫 | Iphlpapi.lib |
| Dll | Iphlpapi.dll |