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

Unicode 字符串，指定 DHCP 服务器的 IP 地址或主机名。

[in] OptionID

DHCP_OPTION_ID 值，该值包含唯一标识要从 DHCP 服务器中删除的特定选项的代码。

[in] ScopeInfo

DHCP_OPTION_SCOPE_INFO 结构，其中包含描述要从中删除选项值的特定范围 (默认值、服务器、作用域或 IPv4 预留级别) 的信息。

返回值

此函数在调用成功后返回 ERROR_SUCCESS 。 否则，它将返回 DHCP 服务器管理 API 错误代码之一。

返回代码	说明
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
Library	Dhcpsapi.lib
DLL	Dhcpsapi.dll

另请参阅

DHCP_OPTION_SCOPE_INFO

DhcpRemoveOptionValueV5

DhcpSetOptionValue