DhcpGetOptionValue 函式會擷取 DHCP 選項值, (特定範圍的選項代碼和相關聯的數據) 。
語法
DWORD DHCP_API_FUNCTION DhcpGetOptionValue(
[in] DHCP_CONST WCHAR *ServerIpAddress,
[in] DHCP_OPTION_ID OptionID,
[in] DHCP_CONST DHCP_OPTION_SCOPE_INFO *ScopeInfo,
[out] LPDHCP_OPTION_VALUE *OptionValue
);
參數
[in] ServerIpAddress
指定 DHCP 伺服器的 IP 位址或主機名的 Unicode 字串。
[in] OptionID
DHCP_OPTION_ID 值,指定要擷取之選項值的程序代碼。
[in] ScopeInfo
DHCP_OPTION_SCOPE_INFO 結構,其中包含設定選項值範圍的相關信息。
[out] OptionValue
DHCP_OPTION_VALUE 結構,其中包含傳回的選項代碼和數據。
注意
此參數的記憶體必須使用 DhcpRpcFreeMemory 釋放。
傳回值
此函式會在成功呼叫時傳回 ERROR_SUCCESS 。 否則,它會傳回其中一個 DHCP 伺服器管理 API 錯誤碼。
備註
此函式需要參數結構中所有 DHCP_IP_ADDRESS 值的主機位元組順序。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | dhcpsapi.h |
程式庫 | Dhcpsapi.lib |
Dll | Dhcpsapi.dll |