PxeDhcpGetOptionValue 函式 (wdspxe.h)

從 DHCP 封包擷取選項值。

語法

DWORD PXEAPI PxeDhcpGetOptionValue(
  [in]            PVOID pPacket,
  [in]            ULONG uPacketLen,
  [in]            ULONG uInstance,
  [in]            BYTE  bOption,
  [out, optional] PBYTE pbOptionLen,
  [out, optional] PVOID *ppOptionValue
);

參數

[in] pPacket

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

[in] uPacketLen

pReplyPacket 參數指向的封包長度。

[in] uInstance

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

[in] bOption

將擷取其值的選項。

[out, optional] pbOptionLen

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

[out, optional] ppOptionValue

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

傳回值

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

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

規格需求

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

另請參閱

PxeDhcpAppendOption

PxeDhcpGetVendorOptionValue

PxePacketAllocate

Windows 部署服務伺服器函式