PxeProviderSetAttribute, fonction (wdspxe.h)

Article
08/27/2023

Spécifie les attributs du fournisseur.

Syntaxe

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

Paramètres

[in] hProvider

HANDLE passé à la fonction PxeProviderInitialize .

[in] Attribute

Identifie l’attribut à définir.

Valeur	Signification
PXE_PROV_ATTR_FILTER 0	Le paramètre pParameterBuffer pointe vers un ULONG.
PXE_PROV_ATTR_FILTER_IPV6 1	Le paramètre pParameterBuffer pointe vers un ULONG. Utilisez cet attribut avec des paquets DHCPv6. Disponible à partir de Windows 8 et Windows Server 2012.
PXE_PROV_ATTR_IPV6_CAPABLE 2	Pointeur vers une valeur BOOL true pour indiquer que le fournisseur est capable de traiter des paquets IPv6. Par défaut, le serveur suppose qu’un fournisseur n’est pas capable de traiter les paquets IPv6 et ne les remet pas. Disponible à partir de Windows 8 et Windows Server 2012.

[in] pParameterBuffer

Pointeur vers une mémoire tampon. La taille et le contenu de cette mémoire tampon varient en fonction de la valeur du paramètre Attribute .

Si l’attribut est PXE_PROV_ATTR_FILTER, la mémoire tampon contient l’une des valeurs suivantes.

Valeur	Signification
PXE_PROV_FILTER_ALL 0x0000	Le fournisseur doit voir tous les paquets.
PXE_PROV_FILTER_DHCP_ONLY 0x0001	Le fournisseur voit uniquement les paquets DHCP. Si PXE_PROV_ATTR_FILTER_IPV6, le fournisseur voit uniquement les paquets DHCPv6
PXE_PROV_FILTER_PXE_ONLY 0x0002	Le fournisseur voit uniquement les paquets DHCP qui spécifient l’option Dhcp Vendor Class Identifier (60) comme « PXEClient ». Si PXE_PROV_ATTR_FILTER_IPV6, le fournisseur voit uniquement les paquets qui spécifient un OPTION_VENDOR_CLASS DHCPv6 contenant le « PXEClient ».

[in] uParamLen

Taille de la mémoire tampon pointée vers le paramètre pParameterBuffer .

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Configuration requise


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008, Windows Server 2003 avec SP2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wdspxe.h
Bibliothèque	WdsPxe.lib
DLL	WdsPxe.dll

Voir aussi

PxeProviderRecvRequest

Fonctions serveur des services de déploiement Windows

Partager via