dhcpv4QueryPolicyEnforcement 函数 (dhcpsapi.h)

DhcpV4QueryPolicyEnforcement 函数从 DHCP 服务器检索服务器或指定 IPv4 子网上的策略强制状态。

语法

DWORD DHCP_API_FUNCTION DhcpV4QueryPolicyEnforcement(
  [in, optional] LPWSTR          ServerIpAddress,
  [in]           BOOL            fGlobalPolicy,
  [in]           DHCP_IP_ADDRESS SubnetAddress,
  [out]          BOOL            *Enabled
);

参数

[in, optional] ServerIpAddress

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

[in] fGlobalPolicy

如果 为 TRUE ,则检索服务器的策略强制状态。 否则,将检索指定 Ipv4 作用域的策略强制状态。

[in] SubnetAddress

DHCP_IP_ADDRESS 结构,其中包含要检索的策略强制状态的 IPv4 子网地址。

[out] Enabled

指向 BOOL 的指针,指示策略强制实施的状态。 如果 为 TRUE ,则启用策略强制状态。 否则,策略强制状态处于禁用状态。

注意 此内存必须由调用方分配。
 

返回值

如果函数成功,则返回 ERROR_SUCCESS

如果函数失败,它将返回以下代码之一或 DHCP 服务器管理 API 错误代码中的错误代码

含义
ERROR_INVALID_PARAMETER
一个或多个参数无效。
ERROR_DHCP_SUBNET_NOT_PRESENT
指定的 IPv4 子网不存在。

要求

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

另请参阅

DhcpV4AddPolicyRange

DhcpV4CreatePolicy

DhcpV4DeletePolicy

DhcpV4EnumPolicies

DhcpV4GetPolicy

DhcpV4RemovePolicyRange

DhcpV4SetPolicy

DhcpV4SetPolicyEnforcement