<div class="content" name="DHCP_CLIENT_INFO_PB" uuid="6ac8d531-84bb-4e8c-8010-840c41fd72e8"><p>The <b>DHCP_CLIENT_INFO_PB</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="7190663d-86c0-4131-8ec0-f50786b0298e" data-linktype="relative-path">DHCP_CLIENT_FILTER_STATUS_INFO (section 2.2.1.2.96)</a>
structure by including the <b>PolicyName</b> member.</p><dl>
<dd>
<div><pre> typedef struct _DHCP_CLIENT_INFO_PB {
     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;
 } DHCP_CLIENT_INFO_PB, *LPDHCP_CLIENT_INFO_PB;
</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 <b>DHCP_CLIENT_UID</b>
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 length of this string.</p><p><b>ClientComment:</b>  A pointer to a
null-terminated Unicode string containing a description given to the DHCPv4
client. This string is limited to 128 characters, including the terminating
null character.</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 <b>DHCP_HOST_INFO</b>
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 of the other types 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 given to 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
that time, the client has full access to the network.</p><p><b>QuarantineCapable:</b>  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.
This string is limited to 64 characters, including the terminating null
character.</p></div>