2.2.1.2.14 DHCP_CLIENT_INFO_V4

The DHCP_CLIENT_INFO_V4 structure defines information about the DHCPv4 client that is used by the R_DhcpGetClientInfoV4 (section 3.1.4.35) method.

This structure augments the DHCP_CLIENT_INFO (section 2.2.1.2.12) structure by including the additional element bClientType.

 typedef struct _DHCP_CLIENT_INFO_V4 {
   DHCP_IP_ADDRESS ClientIpAddress;
   DHCP_IP_MASK SubnetMask;
   DHCP_CLIENT_UID ClientHardwareAddress;
   LPWSTR ClientName;
   LPWSTR ClientComment;
   DATE_TIME ClientLeaseExpires;
   DHCP_HOST_INFO OwnerHost;
   BYTE bClientType;
 } DHCP_CLIENT_INFO_V4,
  *LPDHCP_CLIENT_INFO_V4;

ClientIpAddress: This is of type DHCP_IP_ADDRESS (section 2.2.1.2.1), a DWORD that contains the DHCPv4 client's IPv4 address.

SubnetMask: This is of type DHCP_IP_MASK (section 2.2.1.2.2), a DWORD that contains the DHCPv4 client's IPv4 subnet mask address.

ClientHardwareAddress: This is of type DHCP_CLIENT_UID (section 2.2.1.2.5), a structure that represents a DHCPv4 client-identifier (section 2.2.1.2.5.1) or a DHCPv4 client unique ID (section 2.2.1.2.5.2). Methods that accept DHCP_CLIENT_INFO_V4 as a parameter specify which representations are acceptable.

ClientName: A pointer to a null-terminated Unicode string that represents the DHCPv4 client's internet host name. There is no restriction on the length of this Unicode string.

ClientComment: A pointer to a null-terminated Unicode string that represents a description of the DHCPv4 client. There is no restriction on the length of this Unicode string.

ClientLeaseExpires: This is of type DATE_TIME (section 2.2.1.2.11), a structure that contains the lease expiry time for the DHCPv4 client. This is UTC time.

OwnerHost: This is of type DHCP_HOST_INFO (section 2.2.1.2.7), a structure that contains information on the DHCPv4 server machine that has provided a lease to the DHCPv4 client.

bClientType: This is of type BYTE that identifies the type of the DHCPv4 client. Possible values for this field are provided in the following table.

Value

Meaning

CLIENT_TYPE_UNSPECIFIED

0x00

A DHCPv4 client other than ones defined in this table.

CLIENT_TYPE_DHCP

0x01

The DHCPv4 client supports the DHCPv4 protocol.

CLIENT_TYPE_BOOTP

0x02

The DHCPv4 client supports the BOOTP protocol ([RFC2132]).

CLIENT_TYPE_BOTH

0x03

The DHCPv4 client identifies both the DHCPv4 and the BOOTP protocols.

CLIENT_TYPE_RESERVATION_FLAG

0x04

There is an IPv4 reservation created for the DHCPv4 client.

CLIENT_TYPE_NONE

0x64

Backward compatibility for manual addressing.