GetRTTAndHopCount 함수(iphlpapi.h)

아티클
08/24/2023

GetRTTAndHopCount 함수는 RTT(왕복 시간) 및 지정된 대상에 대한 홉 수를 결정합니다.

구문

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

매개 변수

[in] DestIpAddress

IPAddr 구조체의 형태로 RTT 및 홉 수를 결정할 대상의 IP 주소입니다.

[out] HopCount

ULONG 변수에 대한 포인터입니다. 이 변수는 DestIpAddress 매개 변수로 지정된 대상에 대한 홉 수를 받습니다.

[in] MaxHops

대상을 검색할 최대 홉 수입니다. 대상에 대한 홉 수가 이 수를 초과하면 함수는 검색을 종료하고 FALSE를 반환합니다.

[out] RTT

DestIpAddress에서 지정한 대상까지의 왕복 시간(밀리초)입니다.

반환 값

함수가 성공하면 반환 값은 TRUE입니다.

함수가 실패하면 반환 값은 FALSE입니다. GetLastError를 호출하여 오류에 대한 오류 코드를 가져옵니다.

설명

IPAddr 데이터 형식에 대한 자세한 내용은 Windows 데이터 형식을 참조하세요. 점선 10진수 표기법과 IPAddr 형식 간에 IP 주소를 변환하려면 inet_addr 및 inet_ntoa 함수를 사용합니다.

예제

다음 예제에서는 왕복 시간 및 홉 수를 검색하여 대상 IP 주소 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());
}

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	iphlpapi.h
라이브러리	Iphlpapi.lib
DLL	Iphlpapi.dll