PxeDhcpv6GetVendorOptionValue 函式 (wdspxe.h)

從 DHCPv6 封包的 OPTION_VENDOR_OPTS (17) 字段擷取選項值。

語法

DWORD PXEAPI PxeDhcpv6GetVendorOptionValue(
  [in]            PVOID pPacket,
  [in]            ULONG uPacketLen,
  [in]            DWORD dwEnterpriseNumber,
  [in]            WORD  wOption,
  [in]            ULONG uInstance,
  [out, optional] PWORD pwOptionLen,
  [out, optional] PVOID *ppOptionValue
);

參數

[in] pPacket

使用 PxePacketAllocate 函式配置的回復封包指標。

[in] uPacketLen

pReplyPacket 參數指向的封包長度。

[in] dwEnterpriseNumber

由因特網指派號碼授權單位 (IANA) 指派給選項廠商的企業號碼。

如需指派企業號碼的詳細資訊，開發人員應該參考由因特網工程工作組 (IETF) 維護的 IPv6 (RFC 3315) 動態主機設定通訊協定。

[in] wOption

將擷取其值的選項。

[in] uInstance

一個型索引，指定要擷取之 wOption 參數的實例。

[out, optional] pwOptionLen

將接收選項值長度的 WORD 位址。

[out, optional] ppOptionValue

PVOID 位址，該位址會接收封包內選項值的位址。

傳回值

下表列出常見的傳回值。 針對所有其他失敗，會傳回適當的 Windows 錯誤碼。

傳回碼/值	Description
ERROR_SUCCESS 0 (0x0)	找到選項並傳回值的指標。
ERROR_FILE_NOT_FOUND 2 (0x2)	選項未找到。
ERROR_INVALID_DATA 13 (0xD)	封包不是有效的 DHCP 封包。 此測試不如 PxeDhcpv6IsValid 函式所使用的測試一樣徹底;只會驗證封包長度和魔術 Cookie。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
目標平台	Windows
標頭	wdspxe.h
程式庫	WdsPxe.lib
Dll	WdsPxe.dll

另請參閱

PxeDhcpv6GetOptionValue

PxePacketAllocate

Windows 部署服務伺服器函式