DhcpCreateOption 函式會在預設選項層級建立預設使用者和廠商類別的選項定義。
語法
DWORD DHCP_API_FUNCTION DhcpCreateOption(
[in] DHCP_CONST WCHAR *ServerIpAddress,
[in] DHCP_OPTION_ID OptionID,
[in] DHCP_CONST DHCP_OPTION *OptionInfo
);
參數
[in] ServerIpAddress
包含 DHCP 伺服器的 IPv4 位址的 Unicode 字串。
[in] OptionID
DHCP_OPTION_ID 值,其中包含唯一的選項標識碼 (也稱為新選項的「選項碼」) 。 其中許多選項識別碼都已定義;您可以在 DHCP 選項和 BOOTP 廠商延伸模組中找到標準 DHCP 和 BOOTP 選項碼的完整清單。
[in] OptionInfo
DHCP_OPTION 結構,其中包含描述新 DHCP 選項的資訊,包括名稱、選擇性批注,以及任何相關的數據項。
傳回值
此函式會在成功呼叫時 傳回ERROR_SUCCESS 。 否則,它會傳回其中一個 DHCP 伺服器管理 API 錯誤碼。
傳回碼 | Description |
---|---|
|
存取 DHCP 伺服器資料庫時發生錯誤。 |
|
指定的選項定義已存在於 DHCP 伺服器資料庫中。 |
備註
選項是由 DHCP 伺服器指派給 DHCP 和 BOOTP 用戶端的用戶端組態參數。 例如,某些常用的選項包括閘道的IP位址, (子網路由器) 、WINS 伺服器和 DNS 伺服器。 一般而言,這些選項會針對特定範圍啟用和設定,但可以針對指定 DHCP 伺服器提供的所有範圍建立預設選項。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2008 R2 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | dhcpsapi.h |
程式庫 | Dhcpsapi.lib |
Dll | Dhcpsapi.dll |