IcmpParseReplies, fonction (icmpapi.h)

Article
08/24/2023

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