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

Статья
03/09/2024

Извлекает значение параметра из пакета DHCP.

Синтаксис

DWORD PXEAPI PxeDhcpGetOptionValue(
  [in]            PVOID pPacket,
  [in]            ULONG uPacketLen,
  [in]            ULONG uInstance,
  [in]            BYTE  bOption,
  [out, optional] PBYTE pbOptionLen,
  [out, optional] PVOID *ppOptionValue
);

Параметры

[in] pPacket

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

[in] uPacketLen

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

[in] uInstance

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

[in] bOption

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

[out, optional] pbOptionLen

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

[out, optional] ppOptionValue

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2008, Windows Server 2003 с пакетом обновления 2 (SP2) [только классические приложения]
Целевая платформа	Windows
Header	wdspxe.h
Библиотека	WdsPxe.lib
DLL	WdsPxe.dll

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

PxeDhcpAppendOption

PxeDhcpGetVendorOptionValue

PxePacketAllocate

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

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