GetRTTAndHopCount, fonction (iphlpapi.h)

Article
08/24/2023

La fonction GetRTTAndHopCount détermine le temps d’aller-retour (RTT) et le nombre de tronçons vers la destination spécifiée.

Syntaxe

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

Paramètres

[in] DestIpAddress

Adresse IP de la destination pour laquelle déterminer le rtt et le nombre de tronçons, sous la forme d’une structure IPAddr .

[out] HopCount

Pointeur vers une variable ULONG . Cette variable reçoit le nombre de tronçons vers la destination spécifiée par le paramètre DestIpAddress .

[in] MaxHops

Nombre maximal de tronçons à rechercher pour la destination. Si le nombre de tronçons dans la destination dépasse ce nombre, la fonction met fin à la recherche et retourne FALSE.

[out] RTT

Temps aller-retour, en millisecondes, jusqu’à la destination spécifiée par DestIpAddress.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE. Appelez GetLastError pour obtenir le code d’erreur de l’échec.

Notes

Pour plus d’informations sur le type de données IPAddr , consultez Types de données Windows. Pour convertir une adresse IP entre la notation décimale en pointillé et le format IPAddr , utilisez les fonctions inet_addr et inet_ntoa .

Exemples

L’exemple suivant récupère et imprime le temps d’aller-retour et le nombre de tronçons sur l’adresse IP de destination 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());
}

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	iphlpapi.h
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll