dhcpSetOptionValues 函式 (dhcpsapi.h)
DhcpSetOptionValues 函式會針對 DHCP 伺服器上定義的特定範圍,設定選項碼及其相關聯的資料值。
語法
DWORD DHCP_API_FUNCTION DhcpSetOptionValues(
[in] DHCP_CONST WCHAR *ServerIpAddress,
[in] DHCP_CONST DHCP_OPTION_SCOPE_INFO *ScopeInfo,
[in] DHCP_CONST DHCP_OPTION_VALUE_ARRAY *OptionValues
);
參數
[in] ServerIpAddress
指定 DHCP 伺服器的 IP 位址或主機名稱的 Unicode 字串指標。
[in] ScopeInfo
DHCP_OPTION_SCOPE_INFO結構的指標,其中包含描述將設定這個選項值之層級 (預設、伺服器、範圍或 IPv4 保留) 的資訊。
[in] OptionValues
DHCP_OPTION_VALUE_ARRAY結構的指標,其中包含選項碼清單,以及要為其設定的對應資料值。
傳回值
此函式會在成功呼叫時 傳回ERROR_SUCCESS 。 否則,它會傳回其中一個 DHCP 伺服器管理 API 錯誤碼。
傳回碼 | 描述 |
---|---|
|
存取 DHCP 伺服器資料庫時發生錯誤。 |
|
在 DHCP 伺服器資料庫中找不到指定的選項定義。 |
|
DHCP 伺服器上沒有指定的 IPv4 子網。 |
|
指定的 DHCP 用戶端不是保留的用戶端。 |
|
DHCP 伺服器上找不到 ScopeInfo 中指定的多播範圍。 |
備註
第一次呼叫此函式時,它會在 DHCP 伺服器資料庫中建立提供的選項值。 否則,它會修改一或多個與預設使用者類別和廠商類別相關聯的選項值。 這些值可以針對 DHCP 伺服器上的預設、伺服器、範圍或 IPv4 保留層級進行設定。
需求
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2008 R2 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | dhcpsapi.h |
程式庫 | Dhcpsapi.lib |
Dll | Dhcpsapi.dll |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將推出:在 2024 年,我們將隨著內容的意見反應機制逐步淘汰 GitHub 問題,並以新的意見反應系統來取代。 如需詳細資訊,請參閱提交並檢視相關的意見反應