DhcpV4AddPolicyRange function (dhcpsapi.h)
The DhcpV4AddPolicyRange function adds an IP address range to a policy.
Syntax
DWORD DHCP_API_FUNCTION DhcpV4AddPolicyRange(
[in, optional] LPWSTR ServerIpAddress,
[in] DHCP_IP_ADDRESS SubnetAddress,
[in] LPWSTR PolicyName,
[in] LPDHCP_IP_RANGE Range
);
Parameters
[in, optional] ServerIpAddress
Pointer to a null-terminated Unicode string that represents the IP address or hostname of the DHCP server.
[in] SubnetAddress
DHCP_IP_ADDRESS structure that contains the IPv4 subnet address of the policy IP address range to add.
[in] PolicyName
A null-terminated Unicode string that represents the name of the policy IP address range to add.
[in] Range
A pointer to a DHCP_IP_RANGE structure that contains the policy IP address range to add.
Return value
If the function succeeds, it returns ERROR_SUCCESS.
If the function fails, it returns one of the following or an error code from DHCP Server Management API Error Codes.
| Value | Meaning |
|---|---|
|
The specified IPv4 subnet does not exist. |
|
The specified policy does not exist. |
|
The specified policy IP range overlaps with one of the policy IP address ranges specified. |
|
The specified policy IP range is not contained within the IP address range of the scope or the specified policy IP range is not valid. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | None supported |
| Minimum supported server | Windows Server 2012 [desktop apps only] |
| Target Platform | Windows |
| Header | dhcpsapi.h |
| Library | Dhcpsapi.lib |
| DLL | Dhcpsapi.dll |