dhcpRemoveOptionV5 函式 (dhcpsapi.h)

  • 發行項

DhcpRemoveOptionV5 函式會移除 DHCP 伺服器上預設選項層級特定使用者類別和廠商類別之特定選項的定義。 這會擴充 DhcpRemoveOption 中支援特定類別和廠商名稱的功能。

語法

DWORD DhcpRemoveOptionV5(
  [in] LPWSTR         ServerIpAddress,
  [in] DWORD          Flags,
  [in] DHCP_OPTION_ID OptionID,
  [in] LPWSTR         ClassName,
  [in] LPWSTR         VendorName
);

參數

[in] ServerIpAddress

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

[in] Flags

指定位旗標，指出選項是否為廠商專屬。 如果不是，這個參數應該是0。

值 意義
0x00000000
 如果已移除預設廠商類別的選項，則應該設定此旗標。
DHCP_FLAGS_OPTION_IS_VENDOR
0x00000003
 如果特定廠商類別已移除選項，則應該設定此旗標。

[in] OptionID

DHCP_OPTION_ID 值，指定要移除之選項的程序代碼。

[in] ClassName

指定選項 DHCP 類別名稱的 Unicode 字串。 這是選擇性參數。

[in] VendorName

指定選項廠商的 Unicode 字串。 此參數是選擇性的，當 Flags 未設定為 DHCP_FLAGS_OPTION_IS_VENDOR 時，應為 NULL。

傳回值

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

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

規格需求

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

另請參閱

DhcpCreateOptionV5