структура ICMPV6_ECHO_REPLY_LH (ipexport.h)

Статья
08/24/2023

Структура ICMPV6_ECHO_REPLY описывает данные, возвращаемые в ответ на Эхо-запрос IPv6.

Синтаксис

typedef struct icmpv6_echo_reply_lh {
  IPV6_ADDRESS_EX Address;
  ULONG           Status;
  unsigned int    RoundTripTime;
} ICMPV6_ECHO_REPLY_LH, *PICMPV6_ECHO_REPLY_LH;

Члены

Address

Тип: IPV6_ADDRESS_EX

IPv6-адрес ответа в виде структуры IPV6_ADDRESS_EX .

Status

Тип: ULONG

Состояние эхо-запроса в виде кода IP_STATUS . Возможные значения для этого элемента определяются в файле заголовка Ipexport.h .

Значение	Значение
IP_SUCCESS 0	Состояние выполнено успешно.
IP_BUF_TOO_SMALL 11001	Буфер ответов был слишком мал.
IP_DEST_NET_UNREACHABLE 11002	Целевая сеть была недоступна. В терминологии IPv6 это значение состояния также определяется как IP_DEST_NO_ROUTE.
IP_DEST_HOST_UNREACHABLE 11003	Узел назначения был недостижим. В терминологии IPv6 это значение состояния также определяется как IP_DEST_ADDR_UNREACHABLE.
IP_DEST_PROT_UNREACHABLE 11004	Протокол назначения был недостижим. В терминологии IPv6 это значение состояния также определяется как IP_DEST_PROHIBITED.
IP_DEST_PORT_UNREACHABLE 11005	Конечный порт был недостижим.
IP_NO_RESOURCES 11006	Недостаточно ресурсов IP.
IP_BAD_OPTION 11007	Указан параметр неверного IP-адреса.
IP_HW_ERROR 11008	Произошла ошибка оборудования.
IP_PACKET_TOO_BIG 11009	Пакет был слишком большим.
IP_REQ_TIMED_OUT 11010	Истек срок действия запроса.
IP_BAD_REQ 11011	Неправильный запрос.
IP_BAD_ROUTE 11012	Неправильный маршрут.
IP_TTL_EXPIRED_TRANSIT 11013	Истек предел прыжка для IPv6 при передаче. В терминологии IPv6 это значение состояния также определяется как IP_HOP_LIMIT_EXCEEDED.
IP_TTL_EXPIRED_REASSEM 11014	Предел прыжка для IPv6 истек во время повторной сборки фрагмента. В терминологии IPv6 это значение состояния также определяется как IP_REASSEMBLY_TIME_EXCEEDED.
IP_PARAM_PROBLEM 11015	Проблема с параметром. В терминологии IPv6 это значение состояния также определяется как IP_PARAMETER_PROBLEM.
IP_SOURCE_QUENCH 11016	Датаграммы поступают слишком быстро, чтобы их можно было обработать, и, возможно, они были удалены.
IP_OPTION_TOO_BIG 11017	Параметр IP был слишком велик.
IP_BAD_DESTINATION 11018	Неправильное назначение.
IP_DEST_UNREACHABLE 11040	Пункт назначения был недостижим.
IP_TIME_EXCEEDED 11041	Время превышено.
IP_BAD_HEADER 11042	Обнаружен недопустимый ip-заголовок.
IP_UNRECOGNIZED_NEXT_HEADER 11043	Обнаружен нераспознанный следующий заголовок.
IP_ICMP_ERROR 11044	Произошла ошибка ICMP.
IP_DEST_SCOPE_MISMATCH 11045	Произошло несоответствие идентификатора целевого область.
IP_GENERAL_FAILURE 11050	Общий сбой. Эта ошибка может быть возвращена для некоторых неправильно сформированных пакетов ICMP.

RoundTripTime

Тип: unsigned int

Время кругового пути в миллисекундах.

Структура ICMPV6_ECHO_REPLY используется функцией Icmp6ParseReplies для возврата ответа на Эхо-запрос IPv6. Данные ответа, содержащие текст сообщения из ответа ICMPV6, соответствуют ICMPV6_ECHO_REPLY структуре в памяти.

Для IPv6 некоторые из возможных значений элемента Status указаны в RFC 2163. Дополнительные сведения см. в разделе www.ietf.org/rfc/rfc2463.txt.

Функцию GetIpErrorString можно использовать для получения строки вспомогательной ошибки IP-адреса для кода ошибки IP_STATUS в элементе Status .

Структура ICMPV6_ECHO_REPLY определяется в общедоступных файлах заголовков, включенных в пакет SDK для Microsoft Windows, но эта структура используется функцией Icmp6ParseReplies в Windows XP и более поздних версиях.

В windows SDK структура ICMPV6_ECHO_REPLY_LH определяется при компиляции приложения, если целевой платформой является Windows XP и более поздних версий (NTDDI_VERSION >= NTDDI_XP, _WIN32_WINNT >= 0x0501или WINVER >= 0x0501). Структура ICMPV6_ECHO_REPLY_LH определяется в ICMPV6_ECHO_REPLY структуре. При компиляции приложения, если целевой платформой не является Windows XP и более поздних версий, структура ICMPV6_ECHO_REPLY не определена.

Эта структура определяется в файле заголовка Ipexport.h , который автоматически включается в файл заголовка Iphlpapi.h . Файл заголовка Ipexport.h никогда не следует использовать напрямую.

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	ipexport.h (включая Iphlpapi.h)