Функция PxeDhcpv6ParseRelayForw (wdspxe.h)

Эта функция может использоваться поставщиком для анализа сообщений RELAY-FORW и их вложенных OPTION_RELAY_MSG сообщений. Возвращаемые сведения можно использовать для создания пакета RELAY-REPL с помощью функции PxeDhcpv6CreateRelayRepl .

Дополнительные сведения о сообщениях RELAY-FORW и OPTION_RELAY_MSG разработчики должны ознакомиться с протоколом конфигурации динамического узла для IPv6 (RFC 3315), поддерживаемым Целевой группой по проектированию Интернета (IETF).

Синтаксис

DWORD PXEAPI PxeDhcpv6ParseRelayForw(
  [in]  PVOID                            pRelayForwPacket,
  [in]  ULONG                            uRelayForwPacketLen,
  [out] PPXE_DHCPV6_NESTED_RELAY_MESSAGE pRelayMessages,
  [in]  ULONG                            nRelayMessages,
  [out] PULONG                           pnRelayMessages,
  [out] PBYTE                            *ppInnerPacket,
  [out] PULONG                           pcbInnerPacket
);

Параметры

[in] pRelayForwPacket

Указывает указатель на сообщение DHCPv6 RELAY-FORW.

[in] uRelayForwPacketLen

Размер сообщения RELAY-FORW в байтах, на которое указывает параметр pRelayForwPacket .

[out] pRelayMessages

Массив PXE_DHCPV6_NESTED_RELAY_MESSAGE структур , инициализированных этой подпрограммой. Размер массива определяется параметром nRelayMessages. Элементы этого массива инициализируются для указания на вложенную цепочку пакетов ретранслятора, закодированных в OPTION_RELAY_MSG. Индекс 0 — это самый внешний вложенный пакет OPTION_RELAY_MSG. По мере увеличения индекса указатели соответствуют более глубоко вложенным пакетам OPTION_RELAY_MSG.

[in] nRelayMessages

Размер массива в количестве элементов массива, на который указывает параметр pRelayMessages .

[out] pnRelayMessages

Указывает указатель на значение ULONG , которое при успешном выполнении получает фактическое количество элементов, записанных в массив pRelayMessages .

[out] ppInnerPacket

Указывает указатель на значение PVOID , которое при успешном выполнении устанавливается в начало самого внутреннего пакета в цепочке ретрансляции. Это исходный пакет запроса клиента.

[out] pcbInnerPacket

Указывает указатель на значение ULONG , которое при успешном выполнении будет иметь размер в байтах самого внутреннего пакета в цепочке ретрансляции, который является исходным пакетом запроса клиента.

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

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

Требования

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