Função PxeProviderSetAttribute (wdspxe.h)

  • Artigo

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