Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

A version of this page is also available for

4/8/2010

This structure describes the data returned in response to an echo request ( IcmpSendEcho).

Syntax


struct icmp_echo_reply { IPAddr Address; unsigned long Status; unsigned long RoundTripTime; unsigned short DataSize; unsigned short Reserved; void FAR* Data; struct ip_option_information Options; } ICMP_ECHO_REPLY;

struct icmp_echo_reply {
  IPAddr 
Address;
  unsigned long 
Status;
  unsigned long 
RoundTripTime;
  unsigned short 
DataSize; 
  unsigned short 
Reserved; 
  void FAR* 
Data;
  struct ip_option_information 
Options; 
} ICMP_ECHO_REPLY;

Members

Address: The replying IP address.

Status

The status of the echo request, in the form of an IP_STATUS code. The possible values for this member are defined in the ipexport.h header file.

Value	Meaning
IP_SUCCESS 11000	The status was success.
IP_BUF_TOO_SMALL 11001	The reply buffer was too small.
IP_DEST_NET_UNREACHABLE 11002	The destination network was unreachable.
IP_DEST_HOST_UNREACHABLE 11003	The destination host was unreachable.
IP_DEST_PROT_UNREACHABLE 11004	The destination protocol was unreachable.
IP_DEST_PORT_UNREACHABLE 11005	The destination port was unreachable.
IP_NO_RESOURCES 11006	Insufficient IP resources were available.
IP_BAD_OPTION 11007	A bad IP option was specified.
IP_HW_ERROR 11008	A hardware error occurred.
IP_PACKET_TOO_BIG 11009	The packet was too big.
IP_REQ_TIMED_OUT 11010	The request timed out.
IP_BAD_REQ 11011	A bad request.
IP_BAD_ROUTE 11012	A bad route.
IP_TTL_EXPIRED_TRANSIT 11013	The time to live (TTL) expired in transit.
IP_TTL_EXPIRED_REASSEM 11014	The time to live expired during fragment reassembly.
IP_PARAM_PROBLEM 11015	A parameter problem.
IP_SOURCE_QUENCH 11016	Datagrams are arriving too fast to be processed and datagrams may have been discarded.
IP_OPTION_TOO_BIG 11017	An IP option was too big.
IP_BAD_DESTINATION 11018	A bad destination.
IP_GENERAL_FAILURE 11050	A general failure. This error can be returned for some malformed ICMP packets.

RoundTripTime: The round trip time (RTT) in milliseconds.

DataSize: The data size, in bytes, of the reply.

Reserved: Reserved for system use.

Data: A pointer to the reply data.

Options: The IP options in the IP header of the reply, in the form of an IP_OPTION_INFORMATIONstructure.

Requirements

Header	icmpapi.h
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

Syntax

Members

Requirements

See Also

Reference