Funzione GetRTTAndHopCount (iphlpapi.h)

Articolo
08/24/2023

La funzione GetRTTAndHopCount determina il tempo di round trip (RTT) e il conteggio degli hop nella destinazione specificata.

Sintassi

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

Parametri

[in] DestIpAddress

Indirizzo IP della destinazione per cui determinare il numero di hop e RTT, sotto forma di struttura IPAddr .

[out] HopCount

Puntatore a una variabile ULONG . Questa variabile riceve il conteggio degli hop nella destinazione specificata dal parametro DestIpAddress .

[in] MaxHops

Numero massimo di hop da cercare nella destinazione. Se il numero di hop nella destinazione supera questo numero, la funzione termina la ricerca e restituisce FALSE.

[out] RTT

Tempo di round trip, espresso in millisecondi, alla destinazione specificata da DestIpAddress.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Chiamare GetLastError per ottenere il codice di errore per l'errore.

Commenti

Per informazioni sul tipo di dati IPAddr , vedere Tipi di dati Windows. Per convertire un indirizzo IP tra notazione decimale punteggiata e formato IPAddr , usare le funzioni inet_addr e inet_ntoa .

Esempio

Nell'esempio seguente viene recuperato e stampato il numero di round trip e hop nell'indirizzo IP di destinazione 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());
}

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	iphlpapi.h
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll