Funzione PxeProviderSetAttribute (wdspxe.h)

Articolo
08/27/2023

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

Condividi tramite