ICMP_ECHO_REPLY32 结构 (ipexport.h)

项目
02/28/2024

ICMP_ECHO_REPLY32 结构描述为响应 64 位平台上的 IPv4 回显请求而返回的数据。

语法

typedef struct icmp_echo_reply32 {
  IPAddr                         Address;
  ULONG                          Status;
  ULONG                          RoundTripTime;
  USHORT                         DataSize;
  USHORT                         Reserved;
  VOID POINTER_32                           *Data;
  struct ip_option_information32 Options;
} ICMP_ECHO_REPLY32, *PICMP_ECHO_REPLY32;

成员

Address

类型： IPAddr

以 IPAddr 结构形式答复的 IPv4 地址。

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

类型： VOID * POINTER_32

指向回复数据的指针。

Options

类型： struct ip_option_information32

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

注解

icmpParseReplies 函数使用 ICMP_ECHO_REPLY32 结构在 64 位平台上返回对 IPv4 回显请求的响应。仅当定义了_WIN64时，才会定义此结构。

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

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

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

要求

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