共用方式為

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值的指標，表示提供者能夠處理 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
程式庫 WdsPxe.lib
Dll WdsPxe.dll

另請參閱

PxeProviderRecvRequest

Windows 部署服務伺服器函式