Fungsi GetRTTAndHopCount (iphlpapi.h)
Fungsi GetRTTAndHopCount menentukan waktu pulang pergi (RTT) dan jumlah hop ke tujuan yang ditentukan.
IPHLPAPI_DLL_LINKAGE BOOL GetRTTAndHopCount(
[in] IPAddr DestIpAddress,
[out] PULONG HopCount,
[in] ULONG MaxHops,
[out] PULONG RTT
);
[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.
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.
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 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());
}
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 |