Baca dalam bahasa Inggris

Bagikan melalui


Fungsi GetRTTAndHopCount (iphlpapi.h)

Fungsi GetRTTAndHopCount menentukan waktu pulang pergi (RTT) dan jumlah hop ke tujuan yang ditentukan.

Sintaks

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

Parameter

[in] DestIpAddress

Alamat IP tujuan untuk menentukan jumlah RTT dan hop, dalam bentuk struktur IPAddr .

[out] HopCount

Penunjuk ke variabel ULONG . Variabel ini menerima jumlah hop ke tujuan yang ditentukan oleh parameter DestIpAddress .

[in] MaxHops

Jumlah maksimum lompatan untuk mencari tujuan. Jika jumlah hop ke tujuan melebihi angka ini, fungsi mengakhiri pencarian dan mengembalikan FALSE.

[out] RTT

Waktu pulang-pergi, dalam milidetik, ke tujuan yang ditentukan oleh DestIpAddress.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Panggil GetLastError untuk mendapatkan kode kesalahan untuk kegagalan tersebut.

Keterangan

Untuk informasi tentang jenis data IPAddr , lihat Jenis Data Windows. Untuk mengonversi alamat IP antara notasi desimal putus-putus dan format IPAddr , gunakan fungsi inet_addr dan inet_ntoa .

Contoh

Contoh berikut mengambil dan mencetak waktu pulang pergi dan jumlah hop ke alamat IP tujuan 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());
}

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header iphlpapi.h
Pustaka Iphlpapi.lib
DLL Iphlpapi.dll

Lihat juga

GetBestInterface

GetBestRoute

Referensi Fungsi Pembantu IP

Halaman Mulai Pembantu IP

IPAddr