Share via

2.2.1.2.80 DHCP_BIND_ELEMENT

  • Article

The DHCP_BIND_ELEMENT structure defines an IPv4 interface binding for the DHCP server over which it receives DHCP packets. This structure is used in the DHCP_BIND_ELEMENT_ARRAY (section 2.2.1.2.81) structure.

 typedef struct _DHCP_BIND_ELEMENT {
   ULONG Flags;
   BOOL fBoundToDHCPServer;
   DHCP_IP_ADDRESS AdapterPrimaryAddress;
   DHCP_IP_ADDRESS AdapterSubnetAddress;
   LPWSTR IfDescription;
   ULONG IfIdSize;
   [size_is(IfIdSize)] LPBYTE IfId;
 } DHCP_BIND_ELEMENT,
  *LPDHCP_BIND_ELEMENT;

Flags: This is of type ULONG, specifying a set of bit flags indicating properties of the interface binding.

Value

Meaning

DHCP_ENDPOINT_FLAG_CANT_MODIFY

0x00000001

The endpoints cannot be modified.

fBoundToDHCPServer: This is of type BOOL and specifies whether this binding is set on the DHCP server.

Value

Meaning

FALSE

0x00000000

It specifies that the interface is not bound to the DHCP server.

TRUE

0x00000001

It specifies that the interface is bound to the DHCP server.

AdapterPrimaryAddress: This is of type DHCP_IP_ADDRESS, a DWORD specifying the IPv4 address assigned to the interface over which the DHCP server is receiving DHCP packets.

AdapterSubnetAddress: This is of type DHCP_IP_ADDRESS, a DWORD specifying the subnet ID from which this interface is receiving DHCP packets.

IfDescription: A pointer, of type LPWSTR, to a null-terminated Unicode string that specifies the name assigned to this interface. The maximum number of characters allowed in this string is 256, excluding the terminating null character.

IfIdSize: This is of type ULONG, and it contains the size of the interface GUID ([MS-DTYP] section 2.3.4) stored in the IfId member.

IfId: This is a pointer to a BYTE that contains the interface GUID ([MS-DTYP] section 2.3.4) assigned to this interface.