ICMP_ECHO_REPLY32 結構 (ipexport.h)

發行項
03/05/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

類型： 結構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)