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

需求

另請參閱

GetBestInterface

GetBestRoute

IP 協助程式函式參考

IP 協助程式起始頁

IPAddr