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

Статья
08/27/2023

Задает атрибуты для поставщика.

Синтаксис

DWORD PXEAPI PxeProviderSetAttribute(
  [in] HANDLE                 hProvider,
  [in] PXE_PROVIDER_ATTRIBUTE Attribute,
  [in] PVOID                  pParameterBuffer,
  [in] ULONG                  uParamLen
);

Параметры

[in] hProvider

HANDLE передается в функцию PxeProviderInitialize .

[in] Attribute

Идентифицирует атрибут для задания.

Значение	Значение
PXE_PROV_ATTR_FILTER 0	Параметр pParameterBuffer указывает на ULONG.
PXE_PROV_ATTR_FILTER_IPV6 1	Параметр pParameterBuffer указывает на ULONG. Используйте этот атрибут с пакетами DHCPv6. Доступно начиная с Windows 8 и Windows Server 2012.
PXE_PROV_ATTR_IPV6_CAPABLE 2	Указатель на значение BOOL , равное TRUE, чтобы указать, что поставщик может обрабатывать пакеты IPv6. По умолчанию сервер предполагает, что поставщик не может обрабатывать пакеты IPv6 и не будет их доставлять. Доступно начиная с Windows 8 и Windows Server 2012.

[in] pParameterBuffer

Указатель на буфер. Размер и содержимое этого буфера зависят от значения параметра Attribute .

Если атрибут PXE_PROV_ATTR_FILTER, буфер содержит одно из следующих значений.

Значение	Значение
PXE_PROV_FILTER_ALL 0x0000	Поставщик предназначен для просмотра всех пакетов.
PXE_PROV_FILTER_DHCP_ONLY 0x0001	Поставщик будет видеть только пакеты DHCP. Если PXE_PROV_ATTR_FILTER_IPV6, поставщик будет видеть только пакеты DHCPv6.
PXE_PROV_FILTER_PXE_ONLY 0x0002	Поставщик будет видеть только пакеты DHCP, которые указывают параметр идентификатора класса поставщика DHCP (60) как "PXEClient". Если PXE_PROV_ATTR_FILTER_IPV6, поставщик будет видеть только пакеты, указывающие OPTION_VENDOR_CLASS DHCPv6, содержащие PXEClient.

[in] uParamLen

Размер буфера, на который указывает параметр pParameterBuffer .

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

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

Требования


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

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

PxeProviderRecvRequest

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

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