Функция IcmpParseReplies (icmpapi.h)
Функция IcmpParseReplies анализирует предоставленный буфер ответов и возвращает количество найденных ответов на эхо-запросы ICMP.
Синтаксис
IPHLPAPI_DLL_LINKAGE DWORD IcmpParseReplies(
[in] LPVOID ReplyBuffer,
[in] DWORD ReplySize
);
Параметры
[in] ReplyBuffer
Буфер, передаваемый в IcmpSendEcho2. Он перезаписывается для хранения массива ICMP_ECHO_REPLY структур, его тип PICMP_ECHO_REPLY.
На 64-разрядной платформе этот буфер перезаписывается для хранения массива ICMP_ECHO_REPLY32 структур, его тип PICMP_ECHO_REPLY32.
[in] ReplySize
Размер (в байтах) буфера, на который указывает параметр ReplyBuffer .
Возвращаемое значение
Функция IcmpParseReplies возвращает количество ответов ICMP, найденных при успешном выполнении. Функция возвращает ноль при ошибке. Вызовите GetLastError для получения дополнительных сведений об ошибке.
Комментарии
Функцию IcmpParseReplies не следует использовать в буфере ответов, ранее переданном в IcmpSendEcho. Функция IcmpSendEcho анализирует этот буфер перед возвратом пользователю. Используйте эту функцию только с IcmpSendEcho2.
Функция IcmpParseReplies экспортируется из Icmp.dll в Windows 2000. Функция IcmpParseReplies экспортируется из Iphlpapi.dll в Windows XP и более поздних версий. Эта функция не рекомендуется использовать для проверки версии Windows. Приложения, которым требуется переносимость этой функции в Windows 2000, Windows XP, Windows Server 2003 и более поздних версиях Windows, не должны статически связываться с файлом Icmp.lib или Iphlpapi.lib . Вместо этого приложение должно проверка наличие IcmpParseReplies в Iphlpapi.dll с вызовами LoadLibrary и GetProcAddress. В противном случае приложение должно проверка наличие IcmpParseReplies в Icmp.dll с вызовами LoadLibrary и GetProcAddress.
Обратите внимание, что директива include для файла заголовка Iphlpapi.h должна быть помещена перед файлом заголовка Icmpapi.h .
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | icmpapi.h |
| Библиотека | Iphlpapi.lib |
| DLL | Iphlpapi.dll в Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP; Icmp.dll в Windows 2000 Server и Windows 2000 Профессиональная |
См. также раздел
IcmpSendecho