icmp6ParseReplies 函数 (icmpapi.h)

Icmp6ParseReplies 函数分析提供的回复缓冲区,如果找到,则返回 IPv6 ICMPv6 回送响应回复。

语法

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

参数

[in] ReplyBuffer

指向传递给 Icmp6SendEcho2 函数的缓冲区的指针。 此参数指向用于保存响应 的ICMPV6_ECHO_REPLY 结构。

[in] ReplySize

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

返回值

成功时,Icmp6ParseReplies 函数返回 1。 在这种情况下,如果目标节点响应或IP_TTL_EXPIRED_TRANSIT则 ReplyBuffer 参数指向的 ICMPV6_ECHO_REPLY 结构中的 Status 成员将IP_SUCCESS

如果返回值为零,则可通过 GetLastError 获取扩展错误信息。

返回代码 说明
ERROR_GEN_FAILURE
发生常规故障。 如果 ReplyBuffer 参数为 NULL 指针或 ReplySize 参数为零,则返回此错误。
其他
使用 FormatMessage 获取返回错误的消息字符串。

注解

IPv6 使用 Icmp6ParseReplies 函数分析 ICMPv6 回显请求产生的回复。 Icmp6ParseReplies 函数分析先前传递给 Icmp6SendEcho2 函数的回复缓冲区。 仅将 Icmp6ParseReplies 函数与 Icmp6SendEcho2 函数一起使用。

Icmp6ParseReplies 函数不能用于之前传递给 IcmpSendEchoIcmpSendEcho2 for IPv4 的答复缓冲区。

对于 IPv4,请使用 IcmpCreateFileIcmpSendEchoIcmpSendEcho2IcmpSendEcho2ExIcmpParseReplies 函数。

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

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 icmpapi.h
Library Iphlpapi.lib
DLL Iphlpapi.dll

另请参阅

GetLastError

ICMPV6_ECHO_REPLY

ICMP_ECHO_REPLY

Icmp6CreateFile

Icmp6Sendecho2

IcmpCloseHandle

IcmpCreateFile

IcmpParseReplies

IcmpSendecho

IcmpSendecho2

IcmpSendecho2Ex