dhcpv4DeletePolicy 函数 (dhcpsapi.h)

项目
08/23/2023

DhcpV4DeletePolicy 函数从 DHCP 服务器中删除现有策略。

语法

DWORD DHCP_API_FUNCTION DhcpV4DeletePolicy(
  [in, optional] LPWSTR          ServerIpAddress,
  [in]           BOOL            fGlobalPolicy,
  [in]           DHCP_IP_ADDRESS SubnetAddress,
  [in]           LPWSTR          PolicyName
);

参数

[in, optional] ServerIpAddress

指向以 null 结尾的 Unicode 字符串的指针，该字符串表示 DHCP 服务器的 IP 地址或主机名。

[in] fGlobalPolicy

如果 为 TRUE ，则删除服务器级别策略。否则，将删除范围级别策略。

[in] SubnetAddress

DHCP_IP_ADDRESS 结构，其中包含要删除的策略的 IPv4 子网地址。

[in] PolicyName

以 null 结尾的 Unicode 字符串，表示要删除的策略的名称。

返回值

如果函数成功，则返回 ERROR_SUCCESS。

如果该函数失败，它将返回以下错误代码之一。

值	含义
ERROR_DHCP_SUBNET_NOT_PRESENT	指定的 IPv4 子网不存在。
ERROR_DHCP_POLICY_NOT_FOUND	找不到 DHCP 服务器策略。
ERROR_INVALID_PARAMETER	参数无效。

要求


最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2012 [仅限桌面应用]
目标平台	Windows
标头	dhcpsapi.h
Library	Dhcpsapi.lib
DLL	Dhcpsapi.dll