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

Статья
08/24/2023

Функция Icmp6ParseReplies анализирует предоставленный буфер ответа и возвращает ответ эха IPv6 ICMPv6, если он найден.

Синтаксис

IPHLPAPI_DLL_LINKAGE DWORD Icmp6ParseReplies(
  [in] LPVOID ReplyBuffer,
  [in] DWORD  ReplySize
);

Параметры

[in] ReplyBuffer

Указатель на буфер, передаваемый в функцию Icmp6SendEcho2 . Этот параметр указывает на структуру ICMPV6_ECHO_REPLY для хранения ответа.

[in] ReplySize

Размер (в байтах) буфера, на который указывает параметр ReplyBuffer .

Возвращаемое значение

Функция Icmp6ParseReplies возвращает 1 при успешном выполнении. В этом случае элемент Status в структуре ICMPV6_ECHO_REPLY , на который указывает параметр ReplyBuffer , будет либо IP_SUCCESS , если целевой узел ответил, либо IP_TTL_EXPIRED_TRANSIT.

Если возвращаемое значение равно нулю, расширенные сведения об ошибке доступны через GetLastError.

Код возврата	Описание
ERROR_GEN_FAILURE	Произошел общий сбой. Эта ошибка возвращается, если параметр ReplyBuffer является указателем NULL или параметр ReplySize равен нулю.
Другое	Используйте FormatMessage , чтобы получить строку сообщения для возвращенной ошибки.

Функция Icmp6ParseReplies используется протоколом IPv6 для анализа ответов, полученных в результате эхо-запроса ICMPv6. Функция Icmp6ParseReplies анализирует буфер ответов, ранее переданный функции Icmp6SendEcho2 . Используйте функцию Icmp6ParseReplies только с функцией Icmp6SendEcho2 .

Функцию Icmp6ParseReplies нельзя использовать в буфере ответов, ранее переданном в IcmpSendEcho или IcmpSendEcho2 для IPv4.

Для IPv4 используйте функции IcmpCreateFile, IcmpSendEcho, IcmpSendEcho2, IcmpSendEcho2Ex и IcmpParseReplies .

Обратите внимание, что директива include для файла заголовка Iphlpapi.h должна быть помещена перед файлом заголовка Icmpapi.h .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	icmpapi.h
Библиотека	Iphlpapi.lib
DLL	Iphlpapi.dll