GetRTTAndHopCount-Funktion (iphlpapi.h)

Artikel
08/24/2023

Die GetRTTAndHopCount-Funktion bestimmt die Roundtripzeit (Roundtrip time, RTT) und die Hopanzahl zum angegebenen Ziel.

Syntax

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

Parameter

[in] DestIpAddress

IP-Adresse des Ziels, für das die RTT- und Hopanzahl bestimmt werden soll, in Form einer IPAddr-Struktur .

[out] HopCount

Zeiger auf eine ULONG-Variable . Diese Variable empfängt die Hopanzahl für das Ziel, das durch den DestIpAddress-Parameter angegeben wird.

[in] MaxHops

Maximale Anzahl von Hops, die nach dem Ziel gesucht werden sollen. Wenn die Anzahl der Hops zum Ziel diese Zahl überschreitet, beendet die Funktion die Suche und gibt FALSE zurück.

[out] RTT

Roundtripzeit in Millisekunden zum von DestIpAddress angegebenen Ziel.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um den Fehlercode für den Fehler abzurufen.

Hinweise

Informationen zum IPAddr-Datentyp finden Sie unter Windows-Datentypen. Verwenden Sie die Funktionen inet_addr und inet_ntoa, um eine IP-Adresse zwischen gepunkteter Dezimalschreibweise und dem IPAddr-Format zu konvertieren.

Beispiele

Im folgenden Beispiel werden die Roundtripzeit und die Hopanzahl an die Ziel-IP-Adresse 127.0.0.1 abgerufen und ausgegeben.

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	iphlpapi.h
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll