ICMP_ECHO_REPLY structure (ipexport.h)

Article
08/24/2023

La structure ICMP_ECHO_REPLY décrit les données retournées en réponse à une demande d’écho IPv4.

Syntaxe

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;

Membres

Address

Type : IPAddr

Adresse IPv4 de réponse, sous la forme d’une structure IPAddr .

Status

Type : ULONG

Le status de la demande d’écho, sous la forme d’un code IP_STATUS. Les valeurs possibles pour ce membre sont définies dans le fichier d’en-tête Ipexport.h .

Valeur	Signification
IP_SUCCESS 0	Le status a été le succès.
IP_BUF_TOO_SMALL 11001	La mémoire tampon de réponse était trop petite.
IP_DEST_NET_UNREACHABLE 11002	Le réseau de destination était inaccessible.
IP_DEST_HOST_UNREACHABLE 11003	L’hôte de destination était inaccessible.
IP_DEST_PROT_UNREACHABLE 11004	Le protocole de destination était inaccessible.
IP_DEST_PORT_UNREACHABLE 11005	Le port de destination était inaccessible.
IP_NO_RESOURCES 11006	Les ressources IP étaient insuffisantes.
IP_BAD_OPTION 11007	Une option IP incorrecte a été spécifiée.
IP_HW_ERROR 11008	Une erreur matérielle s’est produite.
IP_PACKET_TOO_BIG 11009	Le paquet était trop grand.
IP_REQ_TIMED_OUT 11010	La demande a expiré.
IP_BAD_REQ 11011	Une demande incorrecte.
IP_BAD_ROUTE 11012	Une mauvaise route.
IP_TTL_EXPIRED_TRANSIT 11013	La durée de vie (TTL) a expiré en transit.
IP_TTL_EXPIRED_REASSEM 11014	La durée de vie a expiré pendant le réassemblage du fragment.
IP_PARAM_PROBLEM 11015	Problème de paramètre.
IP_SOURCE_QUENCH 11016	Les datagrammes arrivent trop vite pour être traités et les datagrammes ont peut-être été ignorés.
IP_OPTION_TOO_BIG 11017	Une option IP était trop grande.
IP_BAD_DESTINATION 11018	Une mauvaise destination.
IP_GENERAL_FAILURE 11050	Échec général. Cette erreur peut être retournée pour certains paquets ICMP mal formés.

RoundTripTime

Type : ULONG

Durée d’aller-retour, en millisecondes.

DataSize

Type : USHORT

Taille des données, en octets, de la réponse.

Reserved

Type : USHORT

Réservé pour le système.

Data

Type : PVOID

Pointeur vers les données de réponse.

Options

Type : struct ip_option_information

Options IP dans l’en-tête IP de la réponse, sous la forme d’une structure de IP_OPTION_INFORMATION .

Notes

La structure ICMP_ECHO_REPLY est utilisée par la fonction IcmpParseReplies pour renvoyer la réponse à une demande d’écho IPv4. Sur une plateforme 64 bits, la structure ICMP_ECHO_REPLY32 doit être utilisée.

Pour IPv4, certaines des valeurs possibles pour le membre Status sont spécifiées dans RFC 792.

La fonction GetIpErrorString peut être utilisée pour récupérer la chaîne d’erreur d’assistance IP pour le code d’erreur IP_STATUS dans le membre Status .

La structure ICMP_ECHO_REPLY est définie dans le fichier d’en-tête Ipexport.h qui est automatiquement inclus dans le fichier d’en-tête Iphlpapi.h . Le fichier d’en-tête Ipexport.h ne doit jamais être utilisé directement.

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	ipexport.h (include Iphlpapi.h)