IcmpParseReplies 함수(icmpapi.h)

아티클
08/24/2023

IcmpParseReplies 함수는 제공된 회신 버퍼를 구문 분석하고 찾은 ICMP 에코 요청 응답 수를 반환합니다.

구문

IPHLPAPI_DLL_LINKAGE DWORD IcmpParseReplies(
  [in] LPVOID ReplyBuffer,
  [in] DWORD  ReplySize
);

매개 변수

[in] ReplyBuffer

IcmpSendEcho2에 전달된 버퍼입니다. ICMP_ECHO_REPLY 구조체 의 배열을 저장하도록 다시 작성되며 해당 형식은 PICMP_ECHO_REPLY.

64비트 플랫폼에서 이 버퍼는 ICMP_ECHO_REPLY32 구조체의 배열을 보유하도록 다시 작성되며 해당 형식은 PICMP_ECHO_REPLY32.

[in] ReplySize

ReplyBuffer 매개 변수가 가리키는 버퍼의 크기(바이트)입니다.

반환 값

IcmpParseReplies 함수는 성공 시 발견된 ICMP 응답 수를 반환합니다. 함수는 오류 발생시 0을 반환합니다. 추가 오류 정보는 GetLastError 를 호출합니다.

설명

IcmpParseReplies 함수는 이전에 IcmpSendEcho에 전달된 회신 버퍼에서 사용하면 안 됩니다. IcmpSendEcho 함수는 사용자에게 반환하기 전에 해당 버퍼를 구문 분석합니다. IcmpSendEcho2에서만 이 함수를 사용합니다.

IcmpParseReplies 함수는 Windows 2000의 Icmp.dll 내보냅니다. IcmpParseReplies 함수는 Windows XP 이상의 Iphlpapi.dll 내보냅니다. 이 함수를 사용하려면 Windows 버전 검사를 사용하지 않는 것이 좋습니다. Windows 2000, Windows XP, Windows Server 2003 이상 Windows 버전에서 이 함수를 사용하여 이식성이 필요한 애플리케이션은 Icmp.lib 또는 Iphlpapi.lib 파일에 정적으로 연결해서는 안 됩니다. 대신 애플리케이션은 LoadLibrary 및 GetProcAddress를 호출하여Iphlpapi.dllIcmpParseReplies가 있는지 검사 합니다. 실패하면 애플리케이션이 LoadLibrary 및 GetProcAddress를 호출하여Icmp.dllIcmpParseReplies가 있는지 검사 합니다.

Iphlpapi.h 헤더 파일에 대한 include 지시문은 Icmpapi.h 헤더 파일 앞에 배치해야 합니다.

요구 사항


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