icmpParseReplies 函数 (icmpapi.h)

项目
08/24/2023

IcmpParseReplies 函数分析提供的回复缓冲区，并返回找到的 ICMP 回送请求响应数。

语法

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

parameters

[in] ReplyBuffer

传递给 IcmpSendEcho2 的缓冲区。这会重写为保存 ICMP_ECHO_REPLY 结构的数组，其类型 为PICMP_ECHO_REPLY。

在 64 位平台上，将此缓冲区重写为保存 ICMP_ECHO_REPLY32 结构的数组，其类型 为PICMP_ECHO_REPLY32。

[in] ReplySize

ReplyBuffer 参数指向的缓冲区的大小（以字节为单位）。

返回值

IcmpParseReplies 函数返回成功时发现的 ICMP 响应数。函数在出错时返回零。调用 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.dll 中是否存在 IcmpParseReplies。否则，应用程序应通过调用 LoadLibrary 和 GetProcAddress 来检查 Icmp.dll 中是否存在 IcmpParseReplies。

请注意， Iphlpapi.h 头文件的 include 指令必须放在 Icmpapi.h 头文件之前。

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	icmpapi.h
Library	Iphlpapi.lib
DLL	Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP 上的 Iphlpapi.dll;Windows 2000 Server 和 Windows 2000 专业版上的 Icmp.dll