GetIpStatisticsEx 함수(iphlpapi.h)

아티클
03/02/2024

GetIpStatisticsEx 함수는 현재 컴퓨터에 대한 IP(인터넷 프로토콜) 통계를 검색합니다. GetIpStatisticsEx 함수는 GetIpStatisticsEx가 IPv6(인터넷 프로토콜 버전 6) 프로토콜 제품군도 지원한다는 점에서 GetIpStatistics 함수와 다릅니다.

구문

IPHLPAPI_DLL_LINKAGE ULONG GetIpStatisticsEx(
  [out] PMIB_IPSTATS Statistics,
  [in]  ULONG        Family
);

매개 변수

[out] Statistics

로컬 컴퓨터에 대한 IP 통계를 수신하는 MIB_IPSTATS 구조체에 대한 포인터입니다.

[in] Family

통계를 검색할 프로토콜 패밀리입니다. 이 매개 변수는 다음 값 중 하나여야 합니다.

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

반환 값

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

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

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

설명

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

GetIpStatistics 함수는 로컬 컴퓨터의 IPv4에 대한 통계만 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	iphlpapi.h
라이브러리	Iphlpapi.lib
DLL	Iphlpapi.dll