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

Статья
03/13/2024

Извлекает значения параметров из поля OPTION_VENDOR_OPTS (17) пакета DHCPv6.

Синтаксис

DWORD PXEAPI PxeDhcpv6GetVendorOptionValue(
  [in]            PVOID pPacket,
  [in]            ULONG uPacketLen,
  [in]            DWORD dwEnterpriseNumber,
  [in]            WORD  wOption,
  [in]            ULONG uInstance,
  [out, optional] PWORD pwOptionLen,
  [out, optional] PVOID *ppOptionValue
);

Параметры

[in] pPacket

Указатель на пакет ответа, выделенный с помощью функции PxePacketAllocate .

[in] uPacketLen

Длина пакета, на который указывает параметр pReplyPacket .

[in] dwEnterpriseNumber

Корпоративный номер, назначенный поставщику параметра Центром интернет-номеров (IANA).

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

[in] wOption

Параметр, значение которого будет извлечено.

[in] uInstance

Одноуровневый индекс, указывающий, какой экземпляр параметра wOption следует извлечь.

[out, optional] pwOptionLen

Адрес WORD , который получит длину значения параметра.

[out, optional] ppOptionValue

Адрес PVOID , который получит адрес значения параметра внутри пакета.

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

Общие возвращаемые значения перечислены в следующей таблице. Для всех остальных сбоев возвращается соответствующий код ошибки Windows.

Возвращаемый код или значение	Описание
ERROR_SUCCESS 0 (0x0)	Был найден параметр и возвращен указатель на значение.
ERROR_FILE_NOT_FOUND 2 (0x2)	Параметр не найден.
ERROR_INVALID_DATA 13 (0xD)	Пакет не является допустимым пакетом DHCP. Этот тест не так тщательно, как тесты, используемые функцией PxeDhcpv6IsValid ; Проверяется только длина пакета и волшебный файл cookie.

Требования

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

См. также раздел

PxeDhcpv6GetOptionValue

PxePacketAllocate

Функции сервера служб развертывания Windows

Поделиться через