Функция IcmpParseReplies (icmpapi.h)

Статья
08/24/2023

Функция 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 Профессиональная