IP_OPTION_INFORMATION-Struktur (ipexport.h)

Die IP_OPTION_INFORMATION-Struktur beschreibt die Optionen, die im Header eines IP-Pakets eingeschlossen werden sollen.

Syntax

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

Member

Ttl

Typ: UCHAR

Das Feld Time to Live in einem IPv4-Paketheader. Dies ist das Hoplimit-Feld in einem IPv6-Header.

Tos

Typ: UCHAR

Der Typ des Dienstfelds in einem IPv4-Header. Dieses Element wird derzeit unbeaufsichtigt ignoriert.

Flags

Typ: UCHAR

Das Feld Flags. In IPv4 ist dies das Feld Flags im IPv4-Header. In IPv6 wird dieses Feld durch Optionsheader dargestellt.

Für IPv4 sind die möglichen Werte für das Flags-Element eine Kombination der folgenden Werte, die in der Ipexport.h-Headerdatei definiert sind:

Wert Bedeutung
IP_FLAG_REVERSE
0x01
Dieser Wert bewirkt, dass das IP-Paket einen IP-Routingheader mit der Quelle hinzufügt. Dieser Wert gilt nur für Windows Vista und höher.
IP_FLAG_DF
0x02
Dieser Wert gibt an, dass das Paket nicht fragmentiert werden soll.

OptionsSize

Typ: UCHAR

Die Größe der IP-Optionsdaten in Bytes.

OptionsData

Typ: PUCHAR

Ein Zeiger auf Optionsdaten.

Hinweise

Die IP_OPTION_INFORMATION-Struktur wird verwendet, um die Optionen zu beschreiben, die im Header eines IP-Pakets enthalten sein sollen. Auf einer 64-Bit-Plattform sollte die IP_OPTION_INFORMATION32-Struktur verwendet werden.

Die Werte in den Elementen TTL, TOS und Flags werden in bestimmten Feldern im IP-Header übertragen.

Die Bytes im OptionsData-Member werden im Optionsbereich übertragen, der dem Standard-IP-Header folgt.

Mit Ausnahme der Quellroutenoptionen für IPv4 müssen die Optionsdaten in dem Format vorliegen, das in RFC 791 angegeben über die Leitung übertragen werden soll. Eine IPv4-Quellroutenoption sollte die vollständige Route in den Routendaten enthalten. Der erste Hop wird aus den Daten gezogen, und die Option wird entsprechend neu formatiert. Andernfalls sollte die Routenoption wie in RFC 791 angegeben formatiert werden.

Für die Verwendung mit IPv6 müssen die Optionsdaten in dem Format vorliegen, das über die Leitung übertragen werden soll, wie in RFC 2460 angegeben.

Die IP_OPTION_INFORMATION-Struktur ist ein Mitglied der ICMP_ECHO_REPLY Struktur, die von den Funktionen IcmpSendEcho, IcmpSendEcho2 und Icmp6SendEcho2 verwendet wird.

Diese Struktur wird in der Headerdatei Ipexport.h definiert, die automatisch in der Headerdatei Iphlpapi.h enthalten ist. Die Ipexport.h-Headerdatei sollte nie direkt verwendet werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile ipexport.h (include Iphlpapi.h)

Weitere Informationen

ICMP_ECHO_REPLY

IP_OPTION_INFORMATION32

Icmp6SendEcho2

IcmpSendEcho

IcmpSendEcho2