DhcpCreateOptionV5 函式 (dhcpsapi.h)

  • 發行項

DhcpCreateOptionV5函式會建立 DHCP 選項。

語法

DWORD DhcpCreateOptionV5(
  [in]           LPWSTR         ServerIpAddress,
  [in]           DWORD          Flags,
  [in]           DHCP_OPTION_ID OptionId,
  [in, optional] LPWSTR         ClassName,
  [in, optional] LPWSTR         VendorName,
  [in]           LPDHCP_OPTION  OptionInfo
);

參數

[in] ServerIpAddress

指定 DHCP 伺服器的 IP 位址或主機名稱的 Unicode 字串。

[in] Flags

旗標值，指出選項適用于特定或預設廠商類別。

值 意義
0x00000000
 預設廠商類別會擷取選項值。
DHCP_FLAGS_OPTION_IS_VENDOR
0x00000003
 系統會針對特定廠商類別擷取選項值。 廠商名稱是在 VendorName中提供。

[in] OptionId

DHCP_OPTION_ID 值，其中包含新選項的唯一選項識別碼號碼 (也稱為「選項代碼」) 。 定義其中許多選項識別碼;您可以在 DHCP 選項和 BOOTP 廠商擴充功能中找到標準 DHCP 和 BOOTP選項代碼的完整清單。

[in, optional] ClassName

Unicode 字串，指定將包含此選項之 DHCP 類別的名稱。 這是選擇性欄位。

[in, optional] VendorName

如果 ClassName 中指定的類別是廠商特定的類別，則會包含廠商名稱字串的 Unicode 字串。

[in] OptionInfo

DHCP_OPTION 結構，其中包含描述新 DHCP 選項的資訊，包括名稱、選擇性批註，以及任何相關的資料項目。

傳回值

此函式會在成功呼叫時傳回 ERROR_SUCCESS 。 否則，它會傳回其中一個 DHCP 伺服器管理 API 錯誤碼。

傳回碼 描述
ERROR_ACCESS_DENIED
 此呼叫是由不是「DHCP 系統管理員」安全性群組成員的用戶端所執行。
ERROR_DHCP_JET_ERROR
 存取 DHCP 伺服器的資料庫時發生錯誤。
ERROR_DHCP_OPTION_EXISTS
 指定的選項定義已存在於 DHCP 伺服器資料庫中。
ERROR_DHCP_CLASS_NOT_FOUND
 指定的類別名稱未知或格式不正確。

需求

   
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 dhcpsapi.h
程式庫 Dhcpsapi.lib
Dll Dhcpsapi.dll

另請參閱

DHCP_OPTION