DHCP_SUBNET_ELEMENT_DATA_V4 structure (dhcpsapi.h)

The DHCP_SUBNET_ELEMENT_DATA_V4 structure defines an element that describes a feature or restriction of a subnet. Together, a set of elements describes the set of IP addresses served for a subnet by DHCP. DHCP_SUBNET_ELEMENT_DATA_V4 specifically allows for IP reservations that take client type into consideration

.

Syntax

typedef struct _DHCP_SUBNET_ELEMENT_DATA_V4 {
  DHCP_SUBNET_ELEMENT_TYPE      ElementType;
#if ...
  union {
    DHCP_IP_RANGE          *IpRange;
    DHCP_HOST_INFO         *SecondaryHost;
    DHCP_IP_RESERVATION_V4 *ReservedIp;
    DHCP_IP_RANGE          *ExcludeIpRange;
    DHCP_IP_CLUSTER        *IpUsedCluster;
  } Element;
#if ...
  _DHCP_SUBNET_ELEMENT_UNION_V4 _DHCP_SUBNET_ELEMENT_UNION_V4;
#else
  union {
    DHCP_IP_RANGE          *IpRange;
    DHCP_HOST_INFO         *SecondaryHost;
    DHCP_IP_RESERVATION_V4 *ReservedIp;
    DHCP_IP_RANGE          *ExcludeIpRange;
    DHCP_IP_CLUSTER        *IpUsedCluster;
  } Element;
#endif
#else
  _DHCP_SUBNET_ELEMENT_UNION_V4 _DHCP_SUBNET_ELEMENT_UNION_V4;
#endif
} DHCP_SUBNET_ELEMENT_DATA_V4, *LPDHCP_SUBNET_ELEMENT_DATA_V4;

Members

ElementType

DHCP_SUBNET_ELEMENT_TYPE enumeration value describing the type of element in the subsequent field.

Element

Element.IpRange

DHCP_IP_RANGE structure that contains the set of DHCP-served IP addresses. This member is present if ElementType is set to DhcpIpRanges.

Element.SecondaryHost

DHCP_HOST_INFO structure that contains the IP addresses of secondary DHCP servers available on the subnet. This member is present if ElementType is set to DhcpSecondaryHosts.

Element.ReservedIp

DHCP_IP_RESERVATION_V4 structure that contains the set of reserved IP addresses for the subnet. This member is present if ElementType is set to DhcpExcludedIpRanges.

Element.ExcludeIpRange

DHCP_IP_RANGE structure that contains the set of excluded IP addresses. This member is present if ElementType is set to DhcpExcludedIpRanges.

Element.IpUsedCluster

DHCP_IP_CLUSTER structure that contains the set of clusters within the subnet. This member is present if ElementType is set to DhcpIpUsedClusters.

_DHCP_SUBNET_ELEMENT_UNION_V4

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2008, Windows Server 2008 R2 [desktop apps only]
Header	dhcpsapi.h

See also

DHCP_SUBNET_ELEMENT_INFO_ARRAY_V4

DHCP_SUBNET_ELEMENT_TYPE