通过

PxeProviderSetAttribute 函数 (wdspxe.h)

  • 项目

指定提供程序的属性。

语法

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

参数

[in] hProvider

传递给 PxeProviderInitialize 函数的HANDLE。

[in] Attribute

标识要设置的属性。

值 含义
PXE_PROV_ATTR_FILTER
0
 pParameterBuffer 参数指向 ULONG。
PXE_PROV_ATTR_FILTER_IPV6
1
 pParameterBuffer 参数指向 ULONG。 将此属性用于 DHCPv6 数据包。 从 Windows 8 和 Windows Server 2012 开始可用。
PXE_PROV_ATTR_IPV6_CAPABLE
2
 指向 BOOL 值的指针，该值为 TRUE，指示提供程序能够处理 IPv6 数据包。 默认情况下，服务器假定提供程序无法处理 IPv6 数据包，并且不会传递它们。 从 Windows 8 和 Windows Server 2012 开始可用。

[in] pParameterBuffer

指向缓冲区的指针。 此缓冲区的大小和内容因 Attribute 参数的值而异。

如果 Attribute 为 PXE_PROV_ATTR_FILTER，则缓冲区将包含以下值之一。

值 含义
PXE_PROV_FILTER_ALL
0x0000
 提供程序是查看所有数据包。
PXE_PROV_FILTER_DHCP_ONLY
0x0001
 提供程序将仅看到 DHCP 数据包。 如果 PXE_PROV_ATTR_FILTER_IPV6，提供程序将仅看到 DHCPv6 数据包
PXE_PROV_FILTER_PXE_ONLY
0x0002
 提供程序将仅看到指定 DHCP 供应商类标识符选项的 DHCP 数据包 (60) 为“PXEClient”。 如果 PXE_PROV_ATTR_FILTER_IPV6，提供程序将仅看到指定 DHCPv6 OPTION_VENDOR_CLASS包含“PXEClient”的数据包。

[in] uParamLen

pParameterBuffer 参数指向的缓冲区的大小。

返回值

如果函数成功，则返回值 ERROR_SUCCESS。

要求

   
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008、Windows Server 2003 SP2 [仅限桌面应用]
目标平台 Windows
标头 wdspxe.h
Library WdsPxe.lib
DLL WdsPxe.dll

另请参阅

PxeProviderRecvRequest

Windows 部署服务服务器函数