Icmp6ParseReplies, fonction (icmpapi.h)
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 |
|---|---|
|
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. |
|
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 |
Voir aussi
IcmpSendEcho