ICMP_ECHO_REPLY32 structure (ipexport.h)

Article
03/01/2024

La structure ICMP_ECHO_REPLY32 décrit les données retournées en réponse à une demande d’écho IPv4 sur une plateforme 64 bits.

Syntaxe

typedef struct icmp_echo_reply32 {
  IPAddr                         Address;
  ULONG                          Status;
  ULONG                          RoundTripTime;
  USHORT                         DataSize;
  USHORT                         Reserved;
  VOID POINTER_32                           *Data;
  struct ip_option_information32 Options;
} ICMP_ECHO_REPLY32, *PICMP_ECHO_REPLY32;

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 : VOID * POINTER_32

Pointeur vers les données de réponse.

Options

Type : struct ip_option_information32

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

Remarques

La structure ICMP_ECHO_REPLY32 est utilisée par la fonction IcmpParseReplies pour retourner la réponse à une demande d’écho IPv4 sur une plateforme 64 bits. Cette structure est définie uniquement si _WIN64 est défini.

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_REPLY32 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	ipexport.h (include Iphlpapi.h)