PxeProviderSetAttribute-Funktion (wdspxe.h)

2023-08-27

Gibt Attribute für den Anbieter an.

Syntax

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

Parameter

[in] hProvider

HANDLE , das an die PxeProviderInitialize-Funktion übergeben wird.

[in] Attribute

Gibt das festzulegende Attribut an.

Wert	Bedeutung
PXE_PROV_ATTR_FILTER 0	Der Parameter pParameterBuffer verweist auf eine ULONG.
PXE_PROV_ATTR_FILTER_IPV6 1	Der Parameter pParameterBuffer verweist auf eine ULONG. Verwenden Sie dieses Attribut mit DHCPv6-Paketen. Verfügbar ab Windows 8 und Windows Server 2012.
PXE_PROV_ATTR_IPV6_CAPABLE 2	Zeiger auf einen BOOL-Wert , der TRUE ist, um anzugeben, dass der Anbieter IPv6-Pakete verarbeiten kann. Standardmäßig geht der Server davon aus, dass ein Anbieter nicht in der Lage ist, IPv6-Pakete zu verarbeiten und sie nicht zuzustellen. Verfügbar ab Windows 8 und Windows Server 2012.

[in] pParameterBuffer

Ein Zeiger auf einen Puffer. Größe und Inhalt dieses Puffers variieren je nach Wert des Attributparameters .

Wenn Attribut PXE_PROV_ATTR_FILTER ist, enthält der Puffer einen der folgenden Werte.

Wert	Bedeutung
PXE_PROV_FILTER_ALL 0x0000	Anbieter ist, um alle Pakete anzuzeigen.
PXE_PROV_FILTER_DHCP_ONLY 0x0001	Der Anbieter sieht nur DHCP-Pakete. Wenn PXE_PROV_ATTR_FILTER_IPV6, werden dem Anbieter nur DHCPv6-Pakete angezeigt.
PXE_PROV_FILTER_PXE_ONLY 0x0002	Der Anbieter sieht nur DHCP-Pakete, die die Option DHCP Vendor Class Identifier (60) als "PXEClient" angeben. Wenn PXE_PROV_ATTR_FILTER_IPV6, werden dem Anbieter nur Pakete angezeigt, die eine DHCPv6-OPTION_VENDOR_CLASS angeben, die den PXEClient enthält.

[in] uParamLen

Die Größe des Puffers, auf den der pParameterBuffer-Parameter verweist.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008, Windows Server 2003 mit SP2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wdspxe.h
Bibliothek	WdsPxe.lib
DLL	WdsPxe.dll

Weitere Informationen

PxeProviderRecvRequest

Serverfunktionen der Windows-Bereitstellungsdienste