GetIpErrorString 함수(iphlpapi.h)
GetIpErrorString 함수는 IP 도우미 오류 문자열을 검색합니다.
구문
IPHLPAPI_DLL_LINKAGE DWORD GetIpErrorString(
[in] IP_STATUS ErrorCode,
[out] PWSTR Buffer,
[in, out] PDWORD Size
);
매개 변수
[in] ErrorCode
검색할 오류 코드입니다. 이 매개 변수의 가능한 값은 Ipexport.h 헤더 파일에 정의되어 있습니다.
[out] Buffer
함수가 NO_ERROR 함께 반환되는 경우 오류 코드 문자열이 포함된 버퍼에 대한 포인터입니다.
[in, out] Size
버퍼 매개 변수가 가리키는 버퍼의 길이(문자 단위)를 지정하는 DWORD에 대한 포인터로, 종료 null(즉, 버퍼 크기(1을 뺀 값)을 제외합니다.
반환 값
성공 시 NO_ERROR 반환합니다.
함수가 실패하면 FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.
설명
GetIpErrorString 함수를 사용하여 IP 오류 코드에 대한 IP 도우미 오류 문자열을 검색할 수 있습니다. ErrorCode 매개 변수에 전달된 IP_STATUS 오류 코드는 ICMP 및 ICMPv6 함수에서 사용하는 ICMP_ECHO_REPLY, ICMP_ECHO_REPLY32 및 ICMPV6_ECHO_REPLY 구조체의 Status 멤버에 반환됩니다. 이러한 구조를 사용하는 함수에는 Icmp6ParseReplies, Icmp6SendEcho2, IcmpParseReplies, IcmpSendEcho, IcmpSendEcho2 및 IcmpSendEcho2Ex가 포함됩니다.
GetIpErrorString 함수의 구문은 Windows Vista 이상용으로 릴리스된 Microsoft SDK(Windows 소프트웨어 개발 키트)에서 약간 변경되었습니다. Buffer 매개 변수의 데이터 형식이 PWCHAR에서 PWSTR로 변경되었습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | iphlpapi.h |
| 라이브러리 | Iphlpapi.lib |
| DLL | Iphlpapi.dll |