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 結構。

備註

icmpParseReplies函式會使用ICMP_ECHO_REPLY結構，將回應傳回 IPv4 回應要求。在 64 位平臺上，應該使用 ICMP_ECHO_REPLY32 結構。

針對 IPv4，會在RFC 792中指定Status成員的一些可能值。

GetIpErrorString函式可用來擷取Status成員中IP_STATUS錯誤碼的 IP 協助程式錯誤字串。

ICMP_ECHO_REPLY結構定義于Ipexport.h標頭檔中，該標頭檔會自動包含在Iphlpapi.h標頭檔中。不應該直接使用 Ipexport.h 標頭檔。

需求


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	ipexport.h (包含 Iphlpapi.h)