GetIcmpStatisticsEx 함수(iphlpapi.h)

GetIcmpStatisticsEx 함수는 로컬 컴퓨터에 대한 ICMP(Internet Control Message Protocol) 통계를 검색합니다. GetIcmpStatisticsEx 함수는 IPv6 ICMP 통계를 검색할 수 있습니다.

구문

IPHLPAPI_DLL_LINKAGE ULONG GetIcmpStatisticsEx(
  [out] PMIB_ICMP_EX Statistics,
  [in]  ULONG        Family
);

[out] Statistics

로컬 컴퓨터에 대한 ICMP 통계를 포함하는 MIB_ICMP_EX 구조체에 대한 포인터입니다.

[in] Family

ICMP 통계를 검색할 프로토콜 패밀리입니다. 다음 중 하나여야 합니다.

값	의미
AF_INET	IPv4(인터넷 프로토콜 버전 4).
AF_INET6	IPv6(인터넷 프로토콜 버전 6)입니다.

함수가 성공하면 반환 값이 NO_ERROR.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

반환 코드	설명
ERROR_INVALID_PARAMETER	pStats 매개 변수가 NULL이거나 유효한 메모리를 가리키지 않거나 dwFamily 매개 변수가 유효한 값이 아닙니다.
ERROR_NOT_SUPPORTED	이 함수는 함수 호출이 수행된 운영 체제에서 지원되지 않습니다.
기타	FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

GetIpStatisticsEx를 사용하여 로컬 컴퓨터에서 IPv4 또는 IPv6에 대한 ICMP 통계를 가져올 수 있습니다.

GetIcmpStatistics 함수는 로컬 컴퓨터의 IPv4에 대해서만 ICMP 통계를 반환합니다.