ICMPV6_ECHO_REPLY

ICMPV6_ECHO_REPLY structure

The ICMPV6_ECHO_REPLY structure describes the data returned in response to an IPv6 echo request.

Syntax


typedef struct icmpv6_echo_reply_lh {
  IPV6_ADDRESS_EX Address;
  ULONG           Status;
  unsigned int    RoundTripTime;
} ICMPV6_ECHO_REPLY, *PICMPV6_ECHO_REPLY;

Members

Address

Type: IPV6_ADDRESS_EX

The replying IPv6 address, in the form of an IPV6_ADDRESS_EX structure.

Status

Type: ULONG

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.

ValueMeaning
IP_SUCCESS
0

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. In IPv6 terminology, this status value is also defined as IP_DEST_NO_ROUTE.

IP_DEST_HOST_UNREACHABLE
11003

The destination host was unreachable. In IPv6 terminology, this status value is also defined as IP_DEST_ADDR_UNREACHABLE.

IP_DEST_PROT_UNREACHABLE
11004

The destination protocol was unreachable. In IPv6 terminology, this status value is also defined as IP_DEST_PROHIBITED.

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 hop limit for IPv6 expired in transit. In IPv6 terminology, this status value is also defined as IP_HOP_LIMIT_EXCEEDED.

IP_TTL_EXPIRED_REASSEM
11014

The hop limit for IPv6 expired during fragment reassembly. In IPv6 terminology, this status value is also defined as IP_REASSEMBLY_TIME_EXCEEDED.

IP_PARAM_PROBLEM
11015

A parameter problem. In IPv6 terminology, this status value is also defined as IP_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_DEST_UNREACHABLE
11040

The destination was unreachable.

IP_TIME_EXCEEDED
11041

The time was exceeded.

IP_BAD_HEADER
11042

A bad IP header was encountered.

IP_UNRECOGNIZED_NEXT_HEADER
11043

An unrecognized next header was encountered.

IP_ICMP_ERROR
11044

An ICMP error occurred.

IP_DEST_SCOPE_MISMATCH
11045

A destination scope ID mismatch occurred.

IP_GENERAL_FAILURE
11050

A general failure. This error can be returned for some malformed ICMP packets.

 

RoundTripTime

Type: unsigned int

The round trip time, in milliseconds.

Remarks

The ICMPV6_ECHO_REPLY structure is used by the Icmp6ParseReplies function to return the response to an IPv6 echo request. The reply data that contains the message body from the ICMPV6 response follows the ICMPV6_ECHO_REPLY structure in memory.

For IPv6, some of the possible values for the Status member are specified in RFC 2163. For more information, see www.ietf.org/rfc/rfc2463.txt.

The GetIpErrorString function can be used to retrieve the IP helper error string for the IP_STATUS error code in the Status member.

The ICMPV6_ECHO_REPLY structure is defined in public header files included in the Microsoft Windows Software Development Kit (SDK), but this structure is used by the Icmp6ParseReplies function on Windows XP and later.

In the Windows SDK, the ICMPV6_ECHO_REPLY_LH structure is defined when compiling an application if the target platform is Windows XP and later (NTDDI_VERSION >= NTDDI_XP, _WIN32_WINNT >= 0x0501, or WINVER >= 0x0501). The ICMPV6_ECHO_REPLY_LH structure is typedefed to the ICMPV6_ECHO_REPLY structure. When compiling an application if the target platform is not Windows XP and later, the ICMPV6_ECHO_REPLY structure is undefined.

This structure is defined in the Ipexport.h header file which is automatically included in the Iphlpapi.h header file. The Ipexport.h header file should never be used directly.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Ipexport.h (include Iphlpapi.h)

See also

GetIpErrorString
Icmp6CreateFile
Icmp6ParseReplies
Icmp6SendEcho2
IcmpCloseHandle
IP_OPTION_INFORMATION
IP Helper Start Page
IP Helper Structures
IPV6_ADDRESS_EX

 

 

Community Additions

ADD
Show:
© 2016 Microsoft