ICMPV6_ECHO_REPLY_LH 结构 (ipexport.h)
ICMPV6_ECHO_REPLY结构描述为响应 IPv6 回显请求而返回的数据。
语法
typedef struct icmpv6_echo_reply_lh {
IPV6_ADDRESS_EX Address;
ULONG Status;
unsigned int RoundTripTime;
} ICMPV6_ECHO_REPLY_LH, *PICMPV6_ECHO_REPLY_LH;
成员
Address
类型: IPV6_ADDRESS_EX
答复的 IPv6 地址,采用 IPV6_ADDRESS_EX 结构的形式。
Status
类型: ULONG
回显请求的状态,采用 IP_STATUS 代码的形式。 此成员的可能值在 Ipexport.h 头文件中定义。
值 |
含义 |
- IP_SUCCESS
- 0
|
状态为“成功”。
|
- IP_BUF_TOO_SMALL
- 11001
|
回复缓冲区太小。
|
- IP_DEST_NET_UNREACHABLE
- 11002
|
无法访问目标网络。 在 IPv6 术语中,此状态值也定义为 IP_DEST_NO_ROUTE。
|
- IP_DEST_HOST_UNREACHABLE
- 11003
|
无法访问目标主机。 在 IPv6 术语中,此状态值也定义为 IP_DEST_ADDR_UNREACHABLE。
|
- IP_DEST_PROT_UNREACHABLE
- 11004
|
无法访问目标协议。 在 IPv6 术语中,此状态值也定义为 IP_DEST_PROHIBITED。
|
- IP_DEST_PORT_UNREACHABLE
- 11005
|
无法访问目标端口。
|
- IP_NO_RESOURCES
- 11006
|
可用 IP 资源不足。
|
- IP_BAD_OPTION
- 11007
|
指定了错误的 IP 选项。
|
- IP_HW_ERROR
- 11008
|
发生硬件错误。
|
- IP_PACKET_TOO_BIG
- 11009
|
数据包太大。
|
- IP_REQ_TIMED_OUT
- 11010
|
请求超时。 |
- IP_BAD_REQ
- 11011
|
错误的请求。
|
- IP_BAD_ROUTE
- 11012
|
一条糟糕的路线。
|
- IP_TTL_EXPIRED_TRANSIT
- 11013
|
传输过程中 IPv6 的跃点限制已过期。 在 IPv6 术语中,此状态值也定义为 IP_HOP_LIMIT_EXCEEDED。
|
- IP_TTL_EXPIRED_REASSEM
- 11014
|
片段重新组合期间 IPv6 的跃点限制已过期。 在 IPv6 术语中,此状态值也定义为 IP_REASSEMBLY_TIME_EXCEEDED。
|
- IP_PARAM_PROBLEM
- 11015
|
参数问题。 在 IPv6 术语中,此状态值也定义为 IP_PARAMETER_PROBLEM。
|
- IP_SOURCE_QUENCH
- 11016
|
数据报到达太快,无法处理,数据报可能已被丢弃。
|
- IP_OPTION_TOO_BIG
- 11017
|
IP 选项太大。
|
- IP_BAD_DESTINATION
- 11018
|
一个糟糕的目标。
|
- IP_DEST_UNREACHABLE
- 11040
|
无法访问目标。
|
- IP_TIME_EXCEEDED
- 11041
|
已超出时间。
|
- IP_BAD_HEADER
- 11042
|
遇到错误的 IP 标头。
|
- IP_UNRECOGNIZED_NEXT_HEADER
- 11043
|
遇到无法识别的下一个标头。
|
- IP_ICMP_ERROR
- 11044
|
发生 ICMP 错误。
|
- IP_DEST_SCOPE_MISMATCH
- 11045
|
目标范围 ID 不匹配。
|
- IP_GENERAL_FAILURE
- 11050
|
常规故障。 对于某些格式不正确的 ICMP 数据包,可能会返回此错误。
|
RoundTripTime
类型: unsigned int
往返时间(以毫秒为单位)。
ICMPV6_ECHO_REPLY结构由 Icmp6ParseReplies 函数用来返回对 IPv6 回显请求的响应。 包含来自 ICMPV6 响应的消息正文的回复数据遵循内存中的 ICMPV6_ECHO_REPLY 结构。
对于 IPv6, 状态 成员的某些可能值在 RFC 2163 中指定。 有关详细信息,请参阅 www.ietf.org/rfc/rfc2463.txt。
GetIpErrorString 函数可用于检索状态成员中IP_STATUS错误代码的 IP 帮助程序错误字符串。
ICMPV6_ECHO_REPLY 结构在 Microsoft Windows 软件开发工具包 (SDK) 中包含的公共头文件中定义,但此结构由 Windows XP 和更高版本的 Icmp6ParseReplies 函数使用。
在 Windows SDK 中,如果目标平台是 Windows XP,则编译应用程序时定义 ICMPV6_ECHO_REPLY_LH 结构,并且以后 (NTDDI_VERSION >= NTDDI_XP
、 _WIN32_WINNT >= 0x0501
或 WINVER >= 0x0501
) 。 ICMPV6_ECHO_REPLY_LH 结构的类型为ICMPV6_ECHO_REPLY结构。 如果目标平台不是 Windows XP 及更高版本,则编译应用程序时, ICMPV6_ECHO_REPLY 结构未定义。
此结构在 Ipexport.h 头文件中定义,该文件自动包含在 Iphlpapi.h 头文件中。 永远不应直接使用 Ipexport.h 头文件。
要求
|
|
最低受支持的客户端 |
Windows XP [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
标头 |
ipexport.h (包括 Iphlpapi.h) |
另请参阅
GetIpErrorString
IP 帮助程序起始页
IP 帮助程序结构
IPV6_ADDRESS_EX
IP_OPTION_INFORMATION
Icmp6CreateFile
Icmp6ParseReplies
Icmp6Sendecho2
IcmpCloseHandle