DhcpRemoveOptionValue 函式 (dhcpsapi.h)

  • 發行項

DhcpRemoveOptionValue 函式會移除指定範圍之預設使用者類別和廠商類別 DHCP4 伺服器上特定選項的選項值。

語法

DWORD DHCP_API_FUNCTION DhcpRemoveOptionValue(
  [in] DHCP_CONST WCHAR                  *ServerIpAddress,
  [in] DHCP_OPTION_ID                    OptionID,
  [in] DHCP_CONST DHCP_OPTION_SCOPE_INFO *ScopeInfo
);

參數

[in] ServerIpAddress

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

[in] OptionID

DHCP_OPTION_ID 值，其中包含唯一識別要從 DHCP 伺服器中移除之特定選項的程式代碼。

[in] ScopeInfo

DHCP_OPTION_SCOPE_INFO 結構，其中包含描述要從中移除選項值之特定範圍 (、伺服器、範圍或 IPv4 保留) 層級的資訊。

傳回值

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

傳回碼 Description
ERROR_DHCP_JET_ERROR
 存取 DHCP 伺服器資料庫時發生錯誤。
ERROR_DHCP_OPTION_NOT_PRESENT
 在 DHCP 伺服器資料庫中找不到指定的選項定義。
ERROR_DHCP_SUBNET_NOT_PRESENT
 DHCP 伺服器上未定義指定的 IPv4 子網。
ERROR_DHCP_NOT_RESERVED_CLIENT
 指定的 DHCP 用戶端不是保留的用戶端。

規格需求

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

另請參閱

DHCP_OPTION_SCOPE_INFO

DhcpRemoveOptionValueV5

DhcpSetOptionValue