Funzione PxeProviderSetAttribute (wdspxe.h)

  • Articolo

Specifica gli attributi per il provider.

Sintassi

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

Parametri

[in] hProvider

HANDLE passato alla funzione PxeProviderInitialize .

[in] Attribute

Identifica l'attributo da impostare.

Valore Significato
PXE_PROV_ATTR_FILTER
0
 Il parametro pParameterBuffer punta a un oggetto ULONG.
PXE_PROV_ATTR_FILTER_IPV6
1
 Il parametro pParameterBuffer punta a un oggetto ULONG. Usare questo attributo con pacchetti DHCPv6. Disponibile a partire da Windows 8 e Windows Server 2012.
PXE_PROV_ATTR_IPV6_CAPABLE
2
 Puntatore a un valore BOOL che è TRUE per indicare che il provider è in grado di elaborare i pacchetti IPv6. Per impostazione predefinita, il server presuppone che un provider non sia in grado di elaborare i pacchetti IPv6 e non li recapita. Disponibile a partire da Windows 8 e Windows Server 2012.

[in] pParameterBuffer

Puntatore a un buffer. Le dimensioni e il contenuto di questo buffer variano a seconda del valore del parametro Attribute .

Se l'attributo è PXE_PROV_ATTR_FILTER, il buffer contiene uno dei valori seguenti.

Valore Significato
PXE_PROV_FILTER_ALL
0x0000
 Il provider consiste nel visualizzare tutti i pacchetti.
PXE_PROV_FILTER_DHCP_ONLY
0x0001
 Il provider visualizzerà solo pacchetti DHCP. Se PXE_PROV_ATTR_FILTER_IPV6, il provider visualizzerà solo pacchetti DHCPv6
PXE_PROV_FILTER_PXE_ONLY
0x0002
 Il provider visualizzerà solo pacchetti DHCP che specificano l'opzione Identificatore classe fornitore DHCP (60) come "PXEClient". Se PXE_PROV_ATTR_FILTER_IPV6, il provider visualizzerà solo pacchetti che specificano un OPTION_VENDOR_CLASS DHCPv6 contenente "PXEClient".

[in] uParamLen

Dimensioni del buffer a cui punta il parametro pParameterBuffer .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Requisiti

   
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2008, Windows Server 2003 con SP2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wdspxe.h
Libreria WdsPxe.lib
DLL WdsPxe.dll

Vedi anche

PxeProviderRecvRequest

Funzioni server di Servizi di distribuzione Windows