共用方式為


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 部署服務伺服器函式