<div class="content" name="DHCP_CLIENT_FILTER_STATUS_INFO" uuid="7190663d-86c0-4131-8ec0-f50786b0298e"><p>The <b>DHCP_CLIENT_FILTER_STATUS_INFO</b> structure defines
information about the <a href="a9d6a415-4de6-4058-befe-ca2e42764485#gt_c35fc04f-54fe-4570-afd3-c96ca84c8d83" data-linktype="relative-path">DHCPv4
client</a>, including filter status information. The <b>DHCP_CLIENT_FILTER_STATUS_INFO</b>
structure augments the <a href="6a445cf3-6e6c-4e29-9817-ac78adc50336" data-linktype="relative-path">DHCP_CLIENT_INFO_VQ (section 2.2.1.2.19)</a>
structure by including information related to the filters applicable to a DHCPv4
client.</p><dl>
<dd>
<div><pre> typedef struct _DHCP_CLIENT_FILTER_STATUS_INFO {
   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;
 } DHCP_CLIENT_FILTER_STATUS_INFO,
  *LPDHCP_CLIENT_FILTER_STATUS_INFO;
</pre></div>
</dd></dl><p><b>ClientIpAddress:</b>  This is of type <a href="5122557b-b85d-4982-8ffb-98d8d934e353" data-linktype="relative-path">DHCP_IP_ADDRESS (section 2.2.1.2.1)</a>,
a <a href="../ms-dtyp/262627d8-3418-4627-9218-4ffe110850b2" data-linktype="relative-path">DWORD</a>
that contains the DHCPv4 client&#39;s IPv4 address.</p><p><b>SubnetMask:</b>  This is of type <a href="5cd312d5-c29f-4352-9fbb-8119ce48082b" data-linktype="relative-path">DHCP_IP_MASK (section 2.2.1.2.2)</a>,
a DWORD that contains the DHCPv4 client&#39;s IPv4 Subnet mask address.</p><p><b>ClientHardwareAddress:</b>  This is of
type <a href="b4da2d52-9737-46ec-8bc2-1c598fc3b8c8" data-linktype="relative-path">DHCP_CLIENT_UID (section 2.2.1.2.5)</a>,
a structure that represents the <a href="a9d6a415-4de6-4058-befe-ca2e42764485#gt_195d8585-7de6-4574-9abf-9db104aaa40c" data-linktype="relative-path">DHCPv4 client-identifier</a>
(section <a href="7c88f58b-c615-4386-a643-ab05b860a003" data-linktype="relative-path">2.2.1.2.5.1</a>).</p><p><b>ClientName:</b>  A pointer, of type <a href="../ms-dtyp/50e9ef83-d6fd-4e22-a34a-2c6b4e3c24f3" data-linktype="relative-path">LPWSTR</a>,
to a null-terminated <a href="a9d6a415-4de6-4058-befe-ca2e42764485#gt_b069acb4-e364-453e-ac83-42d469bb339e" data-linktype="relative-path">Unicode
string</a> that represents the DHCPv4 client&#39;s Internet host name. There is no
restriction on the length of this Unicode string.</p><p><b>ClientComment:</b>  A pointer, of type
LPWSTR, to a null-terminated Unicode string that represents the description
given to the DHCPv4 client. The maximum number of characters allowed in this
string is 128, including the terminating null character.</p><p><b>ClientLeaseExpires:</b>  This is of type
<a href="0f93bea1-8172-4efa-826a-e12667e1bcee" data-linktype="relative-path">DATE_TIME (section 2.2.1.2.11)</a>,
a structure that contains the lease expiry time for the DHCPv4 client. This is
UTC time.</p><p><b>OwnerHost:</b>  This of type <a href="51e16f4a-cb1d-400a-85c7-defe4cba1609" data-linktype="relative-path">DHCP_HOST_INFO (section 2.2.1.2.7)</a>,
a structure that contains information about the <a href="a9d6a415-4de6-4058-befe-ca2e42764485#gt_746786e7-458f-45aa-ab24-5534a94b4fb3" data-linktype="relative-path">DHCPv4 server</a> machine that
has provided a lease to the DHCPv4 client.</p><p><b>bClientType:</b>  This is of type <a href="../ms-dtyp/d7edc080-e499-4219-a837-1bc40b64bb04" data-linktype="relative-path">BYTE</a>
that identifies the type of the DHCPv4 client. The possible values are shown in
the following table.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>CLIENT_TYPE_UNSPECIFIED 0x00</td>
  <td>A DHCPv4 client other than ones defined in this table.</td>
 </tr><tr>
  <td>CLIENT_TYPE_DCHP 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 identifies both the DHCP and BOOTP protocol.</td>
 </tr><tr>
  <td>CLIENT_TYPE_RESERVATION_FLAG 0x04</td>
  <td>There is an IPv4 reservation created for the DHCPv4 client.</td>
 </tr><tr>
  <td>CLIENT_TYPE_NONE 0x05</td>
  <td>Backward compatibility for manual addressing.</td>
 </tr></tbody></table>
</dd></dl><p><b>AddressState:</b>  This is of type BYTE
that represents the state of the IPv4 address given to the DHCPv4 client. The
following table represents the different values and their meanings.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>ADDRESS_STATE_OFFERED 0x00</td>
  <td>The DHCPv4 client has been offered this IPv4 address.</td>
 </tr><tr>
  <td>ADDRESS_STATE_ACTIVE 0x01</td>
  <td>The IPv4 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; hence it is a bad IPv4 address.</td>
 </tr><tr>
  <td>ADDRESS_STATE_DOOM 0x03</td>
  <td>The IPv4 address is in DOOMED state and is due to be deleted.</td>
 </tr></tbody></table>
</dd></dl><p><b>Status:</b>  This is of type <a href="bb589d00-d890-490c-9b6d-885ff61ac8a0" data-linktype="relative-path">QuarantineStatus (section 2.2.1.1.11)</a>,
an enumeration that contains the health status of the DHCPv4 client, as
validated at the <a href="a9d6a415-4de6-4058-befe-ca2e42764485#gt_f30fdc41-d7c1-422e-b5a8-9dcce071ebeb" data-linktype="relative-path">NAP</a>
server.</p><p><b>ProbationEnds:</b>  This is of type
DATE_TIME, a structure that contains the end time of the probation if the
DHCPv4 client is on probation. For this time period, the DHCPv4 client has full
access to the network.</p><p><b>QuarantineCapable:</b>  This is of type <a href="../ms-dtyp/9d81be47-232e-42cf-8f0d-7a3b29bf2eb2" data-linktype="relative-path">BOOL</a>
that can take on the following values.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>TRUE 1</td>
  <td>The DHCPv4 client machine is quarantine-enabled.</td>
 </tr><tr>
  <td>FALSE 0</td>
  <td>The DHCPv4 client machine is not quarantine-enabled.</td>
 </tr></tbody></table>
</dd></dl><p><b>FilterStatus:</b>  This is of type DWORD
that specifies the status of the link-layer filter.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>FILTER_STATUS_NONE 0x00000001</td>
  <td>The DHCPv4 client MAC address does not match any filter.</td>
 </tr><tr>
  <td>FILTER_STATUS_FULL_MATCH_IN_ALLOW_LIST 0x00000002</td>
  <td>The DHCv4P client 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 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 MAC address has a wildcard match in the allow list.</td>
 </tr><tr>
  <td>FILTER_STATUS_WILDCARD_MATCH_IN_DENY_LIST 0x00000010</td>
  <td>The DHCPv4 client MAC address has a wildcard match in the deny list.</td>
 </tr></tbody></table>
</dd></dl><p> </p></div>