Expand Minimize

DHCP_CLIENT_INFO_V5 structure

The DHCP_CLIENT_INFO_V5 structure defines a client information record used by the DHCP server, extending the definition provided in DHCP_CLIENT_INFO by including client type and address state information.

Note  This structure is used by the following operating system versions: Windows 2000 and later.

Syntax


typedef struct _DHCP_CLIENT_INFO_V5 {
  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;
  BYTE            AddressState;
} DHCP_CLIENT_INFO_V5, *LPDHCP_CLIENT_INFO_V5;

Members

ClientIpAddress

DHCP_IP_ADDRESS value that contains the assigned IP address of the DHCP client.

SubnetMask

DHCP_IP_MASK value that contains the subnet mask value assigned to the DHCP client.

ClientHardwareAddress

DHCP_CLIENT_UID structure containing the MAC address of the client's network interface device.

ClientName

Pointer to a Unicode string that specifies the network name of the DHCP client. This member is optional.

ClientComment

Pointer to a Unicode string that contains a comment associated with the DHCP client. This member is optional.

ClientLeaseExpires

DATE_TIME structure that contains the date and time the DHCP client lease will expire, in UTC time.

OwnerHost

DHCP_HOST_INFO structure that contains information on the DHCP server that assigned the IP address to the client.

bClientType

Specifies the types of dynamic IP address service used by the client.

ValueMeaning
CLIENT_TYPE_UNSPECIFIED

The client's dynamic IP address protocol is unknown.

CLIENT_TYPE_DHCP

The client uses DHCP for dynamic IP address service.

CLIENT_TYPE_BOOTP

The client uses BOOTP for dynamic IP address service.

CLIENT_TYPE_BOTH

The client can use either DHCP or BOOTP for dynamic IP address service.

CLIENT_TYPE_NONE

The client does not use a supported dynamic IP address service.

 

AddressState

Specifies the current state of the client IP address.

ValueMeaning
V5_ADDRESS_STATE_OFFERED

The IP address is currently offered to the client; it has not yet become active.

V5_ADDRESS_STATE_ACTIVE

The IP address is currently in use by the client.

V5_ADDRESS_STATE_DECLINED

The IP address has been declined by the client and has not been released back into the pool.

V5_ADDRESS_STATE_DOOM

The IP address is "doomed", indicating that it is no longer available and will be removed from the pool.

 

Remarks

The DHCP_CLIENT_INFO_V5 structure is returned by the DhcpEnumSubnetClientsV5 function.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Dhcpsapi.h

See also

DATE_TIME
DHCP_HOST_INFO
DHCP_CLIENT_UID
DHCP_CLIENT_INFO_ARRAY_V5
DhcpEnumSubnetClientsV5

 

 

Community Additions

ADD
Show:
© 2014 Microsoft