IP_OPTION_INFORMATION (Compact 2013)

3/26/2014

This structure describes the options to be included in the header of an IP packet.

Syntax

typedef struct ip_option_information {
  UCHAR Ttl;
  UCHAR Tos;
  UCHAR Flags;
  UCHAR OptionsSize;
  PUCHAR OptionsData;
} IP_OPTION_INFORMATION,
  *PIP_OPTION_INFORMATION;

Members

• Ttl
  The Time to Live field in an IPv4 packet header. This is the Hop Limit field in an IPv6 header.

• Tos
  The type of service field in an IPv4 header. This member is currently silently ignored.

• Flags
  The Flags field. In IPv4, this is the Flags field in the IPv4 header. In IPv6, this field is represented by options headers.

  For IPv4, the possible values for the Flags member are a combination of the following values that are defined in the Ipexport.h header file:

  Value	Description
  IP_REVERSE 0x01	This value causes the IP packet to add in an IP routing header with the source.
  IP_FLAG_DF 0x02	This value indicates that the packet should not be fragmented.

• OptionsSize
  The size, in bytes, of IP options data.

• OptionsData
  A pointer to options data.

Remarks

The IP_OPTION_INFORMATION structure is used to describe the options to be included in the header of an IP packet. On a 64-bit platform, the IP_OPTION_INFORMATION32 structure should be used.

The values in the TTL, TOS and Flags members are carried in specific fields in the IP header.

The bytes in the OptionsData member are carried in the options area that follows the standard IP header.

Except for source route options for IPv4, the options data must be in the format to be transmitted on the wire as specified in RFC 791. An IPv4 source route option should contain the full route, first hop through final destination, in the route data. The first hop is pulled out of the data and the option is reformatted accordingly. Otherwise, the route option should be formatted as specified in RFC 791.

For use with IPv6, the options data must be in the format to be transmitted on the wire as specified in RFC 2460.

The IP_OPTION_INFORMATION structure is a member of the ICMP_ECHO_REPLY structure used by the IcmpSendEcho, IcmpSendEcho2, and Icmp6SendEcho2 functions.

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

Header

icmpapi.h

See Also

Reference

IP Helper Structures
ICMP_ECHO_REPLY
Icmp6SendEcho2
IcmpSendEcho
IcmpSendEcho2
ICMP Structures
IP_OPTION_INFORMATION32