<div class="content" name="DHCP_CLIENT_INFO_EX" uuid="99021b06-24d3-4edf-b673-0316e85cf28d"><p>The <b>DHCP_CLIENT_INFO_EX</b> structure encapsulates
information about a DHCPv4 client, including filter status information and the
policy, if any, that resulted in the client&#39;s specific IPv4 address assignment.
This structure augments the <a href="91d65e7e-d5c5-443e-a863-781dba950962" data-linktype="relative-path">DHCP_CLIENT_INFO (section 2.2.1.2.12)</a>
structure by including a list of DHCP properties represented by the field Properties.</p><dl>
<dd>
<div><pre> typedef struct DHCP_CLIENT_INFO_EX {
     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;
     QuarantineStatus Status;
     DATE_TIME ProbationEnds;
     BOOL QuarantineCapable;
     DWORD FilterStatus;
     LPWSTR PolicyName;
     LPDHCP_PROPERTY_ARRAY Properties;
 } DHCP_CLIENT_INFO_EX, *LPDHCP_CLIENT_INFO_EX;
</pre></div>
</dd></dl><p><b>ClientIpAddress:</b>  The client&#39;s IPv4
address.</p><p><b>SubnetMask:</b>  The client&#39;s IPv4
subnet mask.</p><p><b>ClientHardwareAddress:</b>  A <a href="b4da2d52-9737-46ec-8bc2-1c598fc3b8c8" data-linktype="relative-path">DHCP_CLIENT_UID (section 2.2.1.2.5)</a>
structure containing the client&#39;s<a href="a9d6a415-4de6-4058-befe-ca2e42764485#gt_195d8585-7de6-4574-9abf-9db104aaa40c" data-linktype="relative-path">DHCPv4 client-identifier</a>.</p><p><b>ClientName:</b>  A pointer to a
null-terminated Unicode string representing the client&#39;s DHCPv4 internet host
name. There is no restriction on the string length.</p><p><b>ClientComment:</b>  A pointer to a
null-terminated Unicode string representing the client&#39;s DHCPv4 internet host
name. There is no restriction on the string length.</p><p><b>ClientLeaseExpires:</b>  The time at
which the client&#39;s lease on its assigned IPv4 address expires.</p><p><b>OwnerHost:</b>  A <a href="51e16f4a-cb1d-400a-85c7-defe4cba1609" data-linktype="relative-path">DHCP_HOST_INFO (section 2.2.1.2.7)</a>
structure that contains information about the DHCPv4 server that assigned the
client&#39;s IPv4 address.</p><p><b>bClientType:</b>  The type of the DHCPv4
client. This member MUST have one of the following values.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>CLIENT_TYPE_UNSPECIFIED 0x00</td>
  <td>Used for DHCPv4 clients that are not any other type as defined in this table.</td>
 </tr><tr>
  <td>CLIENT_TYPE_DHCP 0x01</td>
  <td>The DHCPv4 client supports the DHCP protocol.</td>
 </tr><tr>
  <td>CLIENT_TYPE_BOOTP 0x02</td>
  <td>The DHCPv4 client supports the BOOTP protocol ([RFC2132]).</td>
 </tr><tr>
  <td>CLIENT_TYPE_BOTH 0x03</td>
  <td>The DHCPv4 client supports the DHCP and BOOTP protocols.</td>
 </tr><tr>
  <td>CLIENT_TYPE_RESERVATION_FLAG 0x04</td>
  <td>An IPv4 registration has been created for the DHCPv4 client.</td>
 </tr><tr>
  <td>CLIENT_TYPE_NONE 0x05</td>
  <td>The client uses manual addressing. This value supports backward compatibility with clients that do not use dynamic IP address assignment.</td>
 </tr></tbody></table>
</dd></dl><p><b>AddressState:</b>  The state of the IPv4
address for the DHCPv4 client. This member MUST be set to one of the following
values.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>ADDRESS_STATE_OFFERED 0x00</td>
  <td>The address has been offered to the client.</td>
 </tr><tr>
  <td>ADDRESS_STATE_ACTIVE 0x01</td>
  <td>The address is active and has an active DHCPv4 client lease record.</td>
 </tr><tr>
  <td>ADDRESS_STATE_DECLINED 0x02</td>
  <td>The IPv4 address request was declined by the DHCPv4 client. The server will not issue this IPv4 address to other clients for a period of time.</td>
 </tr><tr>
  <td>ADDRESS_STATE_DOOM 0x03</td>
  <td>The IPv4 address is in the DOOMED state prior to being deleted.</td>
 </tr></tbody></table>
</dd></dl><p><b>Status:</b>  A <a href="bb589d00-d890-490c-9b6d-885ff61ac8a0" data-linktype="relative-path">QuarantineStatus (section 2.2.1.1.11)</a>
value representing the DHCPv4 client&#39;s health status as validated by the NAP
server.</p><p><b>ProbationEnds:</b>  If the client is on
probation, this member contains the time at which the probation ends. Up to the
time at which probation ends, the client has full access to the network.</p><p><b>QuarantineCapable:</b>  Indicates
whether the client machine is quarantine-enabled. A value of TRUE indicates
that the client machine is quarantine-enabled, whereas FALSE indicates that it
is not.</p><p><b>FilterStatus:</b>  The status of the
link-layer filter. This member MUST be set to one of the following values.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>FILTER_STATUS_NONE 0x00000001</td>
  <td>The DHCPv4 client&#39;s MAC address does not match any filter.</td>
 </tr><tr>
  <td>FILTER_STATUS_FULL_MATCH_IN_ALLOW_LIST 0x00000002</td>
  <td>The DHCPv4 client&#39;s MAC address fully matches an allow-list filter.</td>
 </tr><tr>
  <td>FILTER_STATUS_FULL_MATCH_IN_DENY_LIST 0x00000004</td>
  <td>The DHCPv4 client&#39;s MAC address fully matches a deny-list filter.</td>
 </tr><tr>
  <td>FILTER_STATUS_WILDCARD_MATCH_IN_ALLOW_LIST 0x00000008</td>
  <td>The DHCPv4 client&#39;s MAC address has a wildcard match to an allow-list filter.</td>
 </tr><tr>
  <td>FILTER_STATUS_WILDCARD_MATCH_IN_DENY_LIST 0x00000010</td>
  <td>The DHCPv4 client&#39;s MAC address has a wildcard match to a deny-list filter.</td>
 </tr></tbody></table>
</dd></dl><p><b>PolicyName:</b>  A pointer to a
null-terminated Unicode string containing the name of the scope-level policy,
if any, that resulted in the current IPv4 address being assigned to the client.
The string is limited to 64 characters, including the terminating null
character.</p><p><b>Properties:</b>  A list of properties
that is associated with the given client. See the following list for properties
allowed for the DHCPv4 client. Properties not identified are ignored.</p><p><b>AddressStateEx:</b>  This property is
present if the value of the <a href="64fe0789-4647-4628-a3a2-2ddcc9ae42f0" data-linktype="relative-path">DHCP_PROPERTY_ID (section 2.2.1.1.27)</a>
is DhcpPropIdClientAddressStateEx and the value of the <a href="1511adaa-15d3-4c19-9521-68fb9870848d" data-linktype="relative-path">DHCP_PROPERTY_TYPE (section 2.2.1.1.26)</a>
is DhcpPropTypeDword. When the <b>Value</b> member of the <a href="1ac6e6e5-f2bc-42ef-9d6a-c9457d48c3c3" data-linktype="relative-path">DHCP_PROPERTY (section 2.2.1.2.117)</a>
structure is set to DwordValue, this represents the extended address state for
the client and is set to the following value:</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>V5_ADDRESS_EX_BIT_DISABLE_PTR_RR 0x01</td>
  <td>The reverse record registration has been disabled when doing DNS registration for this entry.</td>
 </tr></tbody></table>
</dd>
<dd>
<p>Values not listed are reserved for future use and
MUST be set to zero.</p>
</dd></dl></div>