ICMP_ECHO_REPLY结构 (ipexport.h)

项目
08/24/2023

ICMP_ECHO_REPLY结构描述为响应 IPv4 回显请求而返回的数据。

语法

typedef struct icmp_echo_reply {
  IPAddr                       Address;
  ULONG                        Status;
  ULONG                        RoundTripTime;
  USHORT                       DataSize;
  USHORT                       Reserved;
  PVOID                        Data;
  struct ip_option_information Options;
} ICMP_ECHO_REPLY, *PICMP_ECHO_REPLY;

成员

Address

类型： IPAddr

回复 IPv4 地址，采用 IPAddr 结构的形式。

Status

类型： ULONG

回显请求的状态，采用 IP_STATUS 代码的形式。此成员的可能值在 Ipexport.h 头文件中定义。

值	含义
IP_SUCCESS 0	状态为成功。
IP_BUF_TOO_SMALL 11001	回复缓冲区太小。
IP_DEST_NET_UNREACHABLE 11002	无法访问目标网络。
IP_DEST_HOST_UNREACHABLE 11003	无法访问目标主机。
IP_DEST_PROT_UNREACHABLE 11004	无法访问目标协议。
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	(TTL 的生存时间) 在传输中过期。
IP_TTL_EXPIRED_REASSEM 11014	片段重组期间生存时间已过期。
IP_PARAM_PROBLEM 11015	参数问题。
IP_SOURCE_QUENCH 11016	数据报到达太快，无法处理，数据报可能已被丢弃。
IP_OPTION_TOO_BIG 11017	IP 选项太大。
IP_BAD_DESTINATION 11018	一个错误的目标。
IP_GENERAL_FAILURE 11050	常规故障。对于某些格式不正确的 ICMP 数据包，可能会返回此错误。

RoundTripTime

类型： ULONG

往返时间（以毫秒为单位）。

DataSize

类型： USHORT

回复的数据大小（以字节为单位）。

Reserved

类型： USHORT

预留给系统使用。

Data

类型： PVOID

指向回复数据的指针。

Options

类型： 结构ip_option_information

答复的 IP 标头中的 IP 选项，采用 IP_OPTION_INFORMATION 结构的形式。

注解

ICMP_ECHO_REPLY结构由 IcmpParseReplies 函数用来返回对 IPv4 回显请求的响应。在 64 位平台上，应使用 ICMP_ECHO_REPLY32 结构。

对于 IPv4，状态成员的某些可能值在 RFC 792 中指定。

GetIpErrorString 函数可用于检索状态成员中IP_STATUS错误代码的 IP 帮助程序错误字符串。

ICMP_ECHO_REPLY结构在 Ipexport.h 头文件中定义，该文件自动包含在 Iphlpapi.h 头文件中。永远不应直接使用 Ipexport.h 头文件。

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	ipexport.h (包括 Iphlpapi.h)