Função PxeProviderSetAttribute (wdspxe.h)

Artigo
08/27/2023

Especifica atributos para o provedor.

Sintaxe

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

Parâmetros

[in] hProvider

HANDLE passado para a função PxeProviderInitialize .

[in] Attribute

Identifica o atributo a ser definido.

Valor	Significado
PXE_PROV_ATTR_FILTER 0	O parâmetro pParameterBuffer aponta para um ULONG.
PXE_PROV_ATTR_FILTER_IPV6 1	O parâmetro pParameterBuffer aponta para um ULONG. Use esse atributo com pacotes DHCPv6. Disponível a partir do Windows 8 e do Windows Server 2012.
PXE_PROV_ATTR_IPV6_CAPABLE 2	Ponteiro para um valor BOOL que é TRUE para indicar que o provedor é capaz de processar pacotes IPv6. Por padrão, o servidor pressupõe que um provedor não é capaz de processar pacotes IPv6 e não os entregará. Disponível a partir do Windows 8 e do Windows Server 2012.

[in] pParameterBuffer

Ponteiro para um buffer. O tamanho e o conteúdo desse buffer variam dependendo do valor do parâmetro Attribute .

Se Attribute for PXE_PROV_ATTR_FILTER, o buffer conterá um dos valores a seguir.

Valor	Significado
PXE_PROV_FILTER_ALL 0x0000	O provedor deve ver todos os pacotes.
PXE_PROV_FILTER_DHCP_ONLY 0x0001	O provedor verá apenas pacotes DHCP. Se PXE_PROV_ATTR_FILTER_IPV6, o provedor verá apenas pacotes DHCPv6
PXE_PROV_FILTER_PXE_ONLY 0x0002	O provedor verá apenas pacotes DHCP que especificam a opção identificador de classe de fornecedor DHCP (60) como "PXEClient". Se PXE_PROV_ATTR_FILTER_IPV6, o provedor verá apenas pacotes que especificam um OPTION_VENDOR_CLASS DHCPv6 que contém o "PXEClient".

[in] uParamLen

O tamanho do buffer apontado pelo parâmetro pParameterBuffer .

Valor retornado

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Requisitos


Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2008, Windows Server 2003 com SP2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wdspxe.h
Biblioteca	WdsPxe.lib
DLL	WdsPxe.dll

Confira também

PxeProviderRecvRequest

Funções de servidor dos Serviços de Implantação do Windows

Compartilhar via