Función GetRTTAndHopCount (iphlpapi.h)

Artículo
08/24/2023

La función GetRTTAndHopCount determina el tiempo de ida y vuelta (RTT) y el recuento de saltos en el destino especificado.

Sintaxis

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

Parámetros

[in] DestIpAddress

Dirección IP del destino para el que se va a determinar el número de RTT y saltos, en forma de una estructura IPAddr .

[out] HopCount

Puntero a una variable ULONG . Esta variable recibe el recuento de saltos al destino especificado por el parámetro DestIpAddress .

[in] MaxHops

Número máximo de saltos que se van a buscar en el destino. Si el número de saltos al destino supera este número, la función finaliza la búsqueda y devuelve FALSE.

[out] RTT

Tiempo de ida y vuelta, en milisegundos, al destino especificado por DestIpAddress.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Llame a GetLastError para obtener el código de error del error.

Comentarios

Para obtener información sobre el tipo de datos IPAddr , vea Tipos de datos de Windows. Para convertir una dirección IP entre la notación decimal con puntos y el formato IPAddr , use las funciones inet_addr y inet_ntoa .

Ejemplos

En el ejemplo siguiente se recupera e imprime el tiempo de ida y vuelta y el recuento de saltos en la dirección IP de destino 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());
}

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	iphlpapi.h
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll