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 获取扩展错误信息。
返回代码 | 说明 |
---|---|
|
发生常规故障。 如果 ReplyBuffer 参数为 NULL 指针或 ReplySize 参数为零,则返回此错误。 |
|
使用 FormatMessage 获取返回错误的消息字符串。 |
注解
IPv6 使用 Icmp6ParseReplies 函数分析 ICMPv6 回显请求产生的回复。 Icmp6ParseReplies 函数分析先前传递给 Icmp6SendEcho2 函数的回复缓冲区。 仅将 Icmp6ParseReplies 函数与 Icmp6SendEcho2 函数一起使用。
Icmp6ParseReplies 函数不能用于之前传递给 IcmpSendEcho 或 IcmpSendEcho2 for IPv4 的答复缓冲区。
对于 IPv4,请使用 IcmpCreateFile、 IcmpSendEcho、 IcmpSendEcho2、 IcmpSendEcho2Ex 和 IcmpParseReplies 函数。
请注意, Iphlpapi.h 头文件的 include 指令必须放在 Icmpapi.h 头文件之前。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | icmpapi.h |
Library | Iphlpapi.lib |
DLL | Iphlpapi.dll |
另请参阅
IcmpSendecho