ICMP_ECHO_REPLY-Struktur (ipexport.h)

Artikel
08/24/2023

Die ICMP_ECHO_REPLY-Struktur beschreibt die Daten, die als Reaktion auf eine IPv4-Echoanforderung zurückgegeben werden.

Syntax

typedef struct icmp_echo_reply {
  IPAddr                       Address;
  ULONG                        Status;
  ULONG                        RoundTripTime;
  USHORT                       DataSize;
  USHORT                       Reserved;
  PVOID                        Data;
  struct ip_option_information Options;
} ICMP_ECHO_REPLY, *PICMP_ECHO_REPLY;

Members

Address

Typ: IPAddr

Die antwortende IPv4-Adresse in Form einer IPAddr-Struktur .

Status

Typ: ULONG

Die status der Echoanforderung in Form eines IP_STATUS Codes. Die möglichen Werte für diesen Member sind in der Headerdatei Ipexport.h definiert.

Wert	Bedeutung
IP_SUCCESS 0	Die status war erfolgreich.
IP_BUF_TOO_SMALL 11001	Der Antwortpuffer war zu klein.
IP_DEST_NET_UNREACHABLE 11002	Das Zielnetzwerk war nicht erreichbar.
IP_DEST_HOST_UNREACHABLE 11003	Der Zielhost war nicht erreichbar.
IP_DEST_PROT_UNREACHABLE 11004	Das Zielprotokoll war nicht erreichbar.
IP_DEST_PORT_UNREACHABLE 11005	Der Zielport war nicht erreichbar.
IP_NO_RESOURCES 11006	Unzureichende IP-Ressourcen waren verfügbar.
IP_BAD_OPTION 11007	Es wurde eine ungültige IP-Option angegeben.
IP_HW_ERROR 11008	Ein Hardwarefehler ist aufgetreten.
IP_PACKET_TOO_BIG 11009	Das Paket war zu groß.
IP_REQ_TIMED_OUT 11010	Das Zeitlimit der Anforderung wurde überschritten.
IP_BAD_REQ 11011	Eine ungültige Anforderung.
IP_BAD_ROUTE 11012	Eine ungültige Route.
IP_TTL_EXPIRED_TRANSIT 11013	Die Gültigkeitsdauer (Time to Live, TTL) ist während der Übertragung abgelaufen.
IP_TTL_EXPIRED_REASSEM 11014	Die Gültigkeitsdauer ist während der erneuten Fragmentassembly abgelaufen.
IP_PARAM_PROBLEM 11015	Ein Parameterproblem.
IP_SOURCE_QUENCH 11016	Datagramme kommen zu schnell an, um verarbeitet zu werden, und Datagramme wurden möglicherweise verworfen.
IP_OPTION_TOO_BIG 11017	Eine IP-Option war zu groß.
IP_BAD_DESTINATION 11018	Ein ungültiges Ziel.
IP_GENERAL_FAILURE 11050	Ein allgemeiner Fehler. Dieser Fehler kann für einige falsch formatierte ICMP-Pakete zurückgegeben werden.

RoundTripTime

Typ: ULONG

Die Roundtripzeit in Millisekunden.

DataSize

Typ: USHORT

Die Datengröße der Antwort in Bytes.

Reserved

Typ: USHORT

Ist für das System reserviert.

Data

Typ: PVOID

Ein Zeiger auf die Antwortdaten.

Options

Typ: Struktur ip_option_information

Die IP-Optionen im IP-Header der Antwort in Form einer IP_OPTION_INFORMATION-Struktur .

Hinweise

Die ICMP_ECHO_REPLY-Struktur wird von der IcmpParseReplies-Funktion verwendet, um die Antwort an eine IPv4-Echoanforderung zurückzugeben. Auf einer 64-Bit-Plattform sollte die ICMP_ECHO_REPLY32-Struktur verwendet werden.

Für IPv4 werden einige der möglichen Werte für das Status-Element in RFC 792 angegeben.

Die GetIpErrorString-Funktion kann verwendet werden, um die IP-Hilfsfehlerzeichenfolge für den IP_STATUS Fehlercode im Status-Element abzurufen.

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

Anforderungen


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)