Skip to content

Latest commit

 

History

History
185 lines (157 loc) · 4.33 KB

nf-dhcpsapi-dhcpaddsubnetelement.md

File metadata and controls

185 lines (157 loc) · 4.33 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:dhcpsapi.DhcpAddSubnetElement
DhcpAddSubnetElement function (dhcpsapi.h)
Adds an element describing a feature or aspect of the subnet to the subnet entry in the DHCP database.
DhcpAddSubnetElement
DhcpAddSubnetElement function [DHCP]
dhcp.dhcpaddsubnetelement
dhcpsapi/DhcpAddSubnetElement
dhcp\dhcpaddsubnetelement.htm
DHCP
4f93d4e8-f41e-4df8-98cc-70a11be75eab
12/05/2018
DhcpAddSubnetElement, DhcpAddSubnetElement function [DHCP], dhcp.dhcpaddsubnetelement, dhcpsapi/DhcpAddSubnetElement
dhcpsapi.h
Windows
None supported
Windows Server 2008 R2 [desktop apps only]
Dhcpsapi.lib
Dhcpsapi.dll
Windows
19H1
DhcpAddSubnetElement
dhcpsapi/DhcpAddSubnetElement
c++
APIRef
kbSyntax
DllExport
Dhcpsapi.dll
DhcpAddSubnetElement

DhcpAddSubnetElement function

-description

The DhcpAddSubnetElement function adds an element describing a feature or aspect of the subnet to the subnet entry in the DHCP database.

-parameters

-param ServerIpAddress [in]

Pointer to a Unicode string that contains the IPv4 address of the subnet DHCP server.

-param SubnetAddress [in]

DHCP_IP_ADDRESS structure that contains the IPv4 address of the subnet.

-param AddElementInfo [in]

Pointer to a DHCP_SUBNET_ELEMENT_DATA structure that contains information about the subnet element corresponding to the IPv4 subnet specified in SubnetAddress.

-returns

This function returns ERROR_SUCCESS upon a successful call. Otherwise, it returns one of the DHCP Server Management API Error Codes.

Return code Description
ERROR_DHCP_JET_ERROR
 An error occurred while accessing the DHCP server database.
ERROR_DHCP_SUBNET_NOT_PRESENT
 The specified IPv4 subnet does not exist.
ERROR_DHCP_INVALID_RANGE
 The specified IPv4 address range either overlaps an existing range or is not valid.
ERROR_DHCP_IPRANGE_CONV_ILLEGAL
 Conversion of a scope to a DHCPv4-only scope or to a BOOTP-only scope is not allowed when DHCPv4 and BOOTP clients are present in the scope to convert. Manually delete either the DHCPv4 or the BOOTP clients from the scope, as appropriate for the type of scope being created.
ERROR_DHCP_IPRANGE_EXISTS
 The specified IPv4 address range already exists.
ERROR_DHCP_MSCOPE_RANGE_TOO_SMALL
 The multicast scope range must allow for at least 256 IPv4 addresses.
ERROR_DHCP_NOT_RESERVED_CLIENT
 The specified DHCPv4 client is not an IPv4 reserverdclient.
ERROR_DHCP_RESERVEDIP_EXISTS
 The specified IPv4 address or hardware address is in use by another DHCPv4 client.
ERROR_DHCP_ADDRESS
 The specified address is not available.

-see-also

DhcpAddSubnetElementV4

DhcpAddSubnetElementV5