ICMPV6_ECHO_REPLY_LH structure (ipexport.h)

Article
08/24/2023

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

Syntaxe

typedef struct icmpv6_echo_reply_lh {
  IPV6_ADDRESS_EX Address;
  ULONG           Status;
  unsigned int    RoundTripTime;
} ICMPV6_ECHO_REPLY_LH, *PICMPV6_ECHO_REPLY_LH;

Membres

Address

Type : IPV6_ADDRESS_EX

Adresse IPv6 de réponse, sous la forme d’une structure de IPV6_ADDRESS_EX .

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. Dans la terminologie IPv6, cette valeur status est également définie comme IP_DEST_NO_ROUTE.
IP_DEST_HOST_UNREACHABLE 11003	L’hôte de destination était inaccessible. Dans la terminologie IPv6, cette valeur status est également définie comme IP_DEST_ADDR_UNREACHABLE.
IP_DEST_PROT_UNREACHABLE 11004	Le protocole de destination était inaccessible. Dans la terminologie IPv6, cette valeur status est également définie comme IP_DEST_PROHIBITED.
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 limite de tronçon pour IPv6 a expiré en transit. Dans la terminologie IPv6, cette valeur status est également définie comme IP_HOP_LIMIT_EXCEEDED.
IP_TTL_EXPIRED_REASSEM 11014	La limite de tronçon pour IPv6 a expiré pendant le réassemblage de fragments. Dans la terminologie IPv6, cette valeur status est également définie comme IP_REASSEMBLY_TIME_EXCEEDED.
IP_PARAM_PROBLEM 11015	Problème de paramètre. Dans la terminologie IPv6, cette valeur status est également définie comme IP_PARAMETER_PROBLEM.
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_DEST_UNREACHABLE 11040	La destination était inaccessible.
IP_TIME_EXCEEDED 11041	Le temps a été dépassé.
IP_BAD_HEADER 11042	Un en-tête IP incorrect a été rencontré.
IP_UNRECOGNIZED_NEXT_HEADER 11043	Un en-tête suivant non reconnu a été rencontré.
IP_ICMP_ERROR 11044	Une erreur ICMP s’est produite.
IP_DEST_SCOPE_MISMATCH 11045	Une incompatibilité d’ID d’étendue de destination s’est produite.
IP_GENERAL_FAILURE 11050	Échec général. Cette erreur peut être retournée pour certains paquets ICMP mal formés.

RoundTripTime

Type : unsigned int

Durée aller-retour, en millisecondes.

Notes

La structure ICMPV6_ECHO_REPLY est utilisée par la fonction Icmp6ParseReplies pour renvoyer la réponse à une demande d’écho IPv6. Les données de réponse qui contiennent le corps du message de la réponse ICMPV6 suivent la structure ICMPV6_ECHO_REPLY en mémoire.

Pour IPv6, certaines des valeurs possibles pour le membre Status sont spécifiées dans RFC 2163. Pour plus d’informations, consultez www.ietf.org/rfc/rfc2463.txt.

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 ICMPV6_ECHO_REPLY est définie dans les fichiers d’en-tête publics inclus dans le Kit de développement logiciel (SDK) Microsoft Windows, mais cette structure est utilisée par la fonction Icmp6ParseReplies sur Windows XP et versions ultérieures.

Dans le Kit de développement logiciel (SDK) Windows, la structure ICMPV6_ECHO_REPLY_LH est définie lors de la compilation d’une application si la plateforme cible est Windows XP et versions ultérieures (NTDDI_VERSION >= NTDDI_XP, _WIN32_WINNT >= 0x0501ou WINVER >= 0x0501). La structure ICMPV6_ECHO_REPLY_LH est typée sur la structure ICMPV6_ECHO_REPLY . Lors de la compilation d’une application si la plateforme cible n’est pas Windows XP et versions ultérieures, la structure ICMPV6_ECHO_REPLY n’est pas définie.

Cette structure 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 XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	ipexport.h (inclure Iphlpapi.h)