IcmpParseReplies, fonction (icmpapi.h)
La fonction IcmpParseReplies analyse la mémoire tampon de réponse fournie et retourne le nombre de réponses de demande d’écho ICMP trouvées.
Syntaxe
IPHLPAPI_DLL_LINKAGE DWORD IcmpParseReplies(
[in] LPVOID ReplyBuffer,
[in] DWORD ReplySize
);
Paramètres
[in] ReplyBuffer
Mémoire tampon passée à IcmpSendEcho2. Il est réécrit pour contenir un tableau de structures ICMP_ECHO_REPLY , son type est PICMP_ECHO_REPLY.
Sur une plateforme 64 bits, cette mémoire tampon est réécrite pour contenir un tableau de structures ICMP_ECHO_REPLY32 , son type est PICMP_ECHO_REPLY32.
[in] ReplySize
Taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre ReplyBuffer .
Valeur retournée
La fonction IcmpParseReplies retourne le nombre de réponses ICMP trouvées en cas de réussite. La fonction retourne zéro en cas d’erreur. Appelez GetLastError pour obtenir des informations supplémentaires sur l’erreur.
Notes
La fonction IcmpParseReplies ne doit pas être utilisée sur une mémoire tampon de réponse précédemment passée à IcmpSendEcho. La fonction IcmpSendEcho analyse cette mémoire tampon avant de revenir à l’utilisateur. Utilisez cette fonction uniquement avec IcmpSendEcho2.
La fonction IcmpParseReplies est exportée à partir du Icmp.dll sur Windows 2000. La fonction IcmpParseReplies est exportée à partir du Iphlpapi.dll sur Windows XP et versions ultérieures. Il n’est pas recommandé de vérifier la version de Windows pour utiliser cette fonction. Les applications nécessitant une portabilité avec cette fonction dans Windows 2000, Windows XP, Windows Server 2003 et versions ultérieures de Windows ne doivent pas être liées de manière statique au fichier Icmp.lib ou Iphlpapi.lib . Au lieu de cela, l’application doit case activée pour la présence d’IcmpParseReplies dans le Iphlpapi.dll avec des appels à LoadLibrary et GetProcAddress. À défaut, l’application doit case activée pour la présence d’IcmpParseReplies dans le Icmp.dll avec des appels à LoadLibrary et GetProcAddress.
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
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | icmpapi.h |
| Bibliothèque | Iphlpapi.lib |
| DLL | Iphlpapi.dll sur Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP ; Icmp.dll sur Windows 2000 Server et Windows 2000 Professionnel |
Voir aussi
IcmpSendEcho