Icmp6ParseReplies, fonction (icmpapi.h)

Article
03/04/2024

La fonction Icmp6ParseReplies analyse la mémoire tampon de réponse fournie et retourne une réponse de réponse d’écho IPv6 ICMPv6 si elle est trouvée.

Syntaxe

IPHLPAPI_DLL_LINKAGE DWORD Icmp6ParseReplies(
  [in] LPVOID ReplyBuffer,
  [in] DWORD  ReplySize
);

Paramètres

[in] ReplyBuffer

Pointeur vers la mémoire tampon passée à la fonction Icmp6SendEcho2 . Ce paramètre pointe vers une structure ICMPV6_ECHO_REPLY pour contenir la réponse.

[in] ReplySize

Taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre ReplyBuffer .

Valeur retournée

La fonction Icmp6ParseReplies retourne 1 en cas de réussite. Dans ce cas, le membre Status dans la structure ICMPV6_ECHO_REPLY pointée par le paramètre ReplyBuffer sera IP_SUCCESS si le nœud cible a répondu ou IP_TTL_EXPIRED_TRANSIT.

Si la valeur de retour est zéro, les informations d’erreur étendues sont disponibles via GetLastError.

Code de retour	Description
ERROR_GEN_FAILURE	Une défaillance générale s’est produite. Cette erreur est retournée si le paramètre ReplyBuffer est un pointeur NULL ou si le paramètre ReplySize est égal à zéro.
Autres	Utilisez FormatMessage pour obtenir la chaîne de message de l’erreur retournée.

Remarques

La fonction Icmp6ParseReplies est utilisée par IPv6 pour analyser les réponses qui résultent d’une demande d’écho ICMPv6. La fonction Icmp6ParseReplies analyse une mémoire tampon de réponse précédemment passée à la fonction Icmp6SendEcho2 . Utilisez la fonction Icmp6ParseReplies uniquement avec la fonction Icmp6SendEcho2 .

La fonction Icmp6ParseReplies ne peut pas être utilisée sur une mémoire tampon de réponse précédemment passée à IcmpSendEcho ou IcmpSendEcho2 pour IPv4.

Pour IPv4, utilisez les fonctions IcmpCreateFile, IcmpSendEcho, IcmpSendEcho2, IcmpSendEcho2Ex et IcmpParseReplies .

Notez que la directive include pour le fichier d’en-tête Iphlpapi.h doit être placée avant le fichier d’en-tête Icmpapi.h .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	icmpapi.h
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll