<div class="content" name="DOMAIN_CONTROLLER_INFOW" uuid="9b85a7a4-8d34-4b9e-9500-bf8644ebfc06"><p>The <b>DOMAIN_CONTROLLER_INFOW</b> structure SHOULD<a id="Appendix_A_Target_8"></a><a aria-label="Product behavior note 8" href="0c858a52-732a-43ec-85dd-e44b357c1898#Appendix_A_8" data-linktype="relative-path">&lt;8&gt;</a> define information returned by
the following methods: <span><a href="86a3fa5b-1f0e-412a-942f-33a10e5e9eff" data-linktype="relative-path">DsrGetDcName (section 3.5.4.3.3)</a></span>,
<span><a href="5de19b7e-4ce3-4cc4-978f-8959f46797ba" data-linktype="relative-path">DsrGetDcNameEx (section 3.5.4.3.2)</a></span>,
and <span><a href="fb8e1146-a045-4c31-98d1-c68507ad5620" data-linktype="relative-path">DsrGetDcNameEx2 (section 3.5.4.3.1)</a></span>.
This structure is used to describe naming and addressing information about a <span><a href="b5e7d25a-40b2-41c8-9611-98f53358af66#gt_76a05049-3531-4abd-aec8-30e19954b4bd" data-linktype="relative-path">DC</a></span>.</p><dl>
<dd>
<div><pre> typedef struct _DOMAIN_CONTROLLER_INFOW {
   [string, unique] wchar_t* DomainControllerName;
   [string, unique] wchar_t* DomainControllerAddress;
   ULONG DomainControllerAddressType;
   GUID DomainGuid;
   [string, unique] wchar_t* DomainName;
   [string, unique] wchar_t* DnsForestName;
   ULONG Flags;
   [string, unique] wchar_t* DcSiteName;
   [string, unique] wchar_t* ClientSiteName;
 } DOMAIN_CONTROLLER_INFOW,
  *PDOMAIN_CONTROLLER_INFOW;
</pre></div>
</dd></dl><p><b>DomainControllerName:</b> A pointer to a
null-terminated UTF-16 string that contains a NetBIOS or <span><a href="b5e7d25a-40b2-41c8-9611-98f53358af66#gt_1769aec9-237e-44ed-9014-1abb3ec6de6e" data-linktype="relative-path">fully
qualified domain name (FQDN)</a></span> of the DC, prefixed with
&#34;\\&#34;.</p><p><b>DomainControllerAddress:</b> A pointer to a
null-terminated <span><a href="b5e7d25a-40b2-41c8-9611-98f53358af66#gt_b069acb4-e364-453e-ac83-42d469bb339e" data-linktype="relative-path">Unicode string</a></span> that
contains the DC address, prefixed with &#34;\\&#34;. The string SHOULD<a id="Appendix_A_Target_9"></a><a aria-label="Product behavior note 9" href="0c858a52-732a-43ec-85dd-e44b357c1898#Appendix_A_9" data-linktype="relative-path">&lt;9&gt;</a> be either a textual
representation of an IPv4/IPv6 address or the <span><a href="b5e7d25a-40b2-41c8-9611-98f53358af66#gt_0334e0bd-2755-42f6-aeff-2d4a22bf4abf" data-linktype="relative-path">NetBIOS name</a></span> of the
DC, determined by the <b>DomainControllerAddressType</b> field.</p><p><b>DomainControllerAddressType:</b> A 32-bit value
indicating the DC address type, which MUST be one, and only one, of the
following.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x00000001</td>
  <td>The address is a string that contains an IPv4 address in dotted-decimal notation (for example, 192.168.0.1), or an IPv6 address in colon-separated notation.&lt;10&gt;</td>
 </tr><tr>
  <td>0x00000002</td>
  <td>The address is a NetBIOS name.</td>
 </tr></tbody></table>
</dd></dl><p><b>DomainGuid:</b> A <span><a href="b5e7d25a-40b2-41c8-9611-98f53358af66#gt_f49694cc-c350-462d-ab8e-816f0103c6c1" data-linktype="relative-path">globally unique identifier
(GUID)</a></span> structure (<span><a href="../ms-dtyp/cca27429-5689-4a16-b2b4-9325d93e4ba2" data-linktype="relative-path">[MS-DTYP]</a></span>
section <span><a href="../ms-dtyp/49e490b8-f972-45d6-a3a4-99f924998d97" data-linktype="relative-path">2.3.4.1</a></span>)
that contains an identifier for the <span><a href="b5e7d25a-40b2-41c8-9611-98f53358af66#gt_b0276eb2-4e65-4cf1-a718-e0920a614aca" data-linktype="relative-path">domain</a></span>. When there
is no domain GUID, this field MUST be set to zero. A GUID SHOULD<a id="Appendix_A_Target_11"></a><a aria-label="Product behavior note 11" href="0c858a52-732a-43ec-85dd-e44b357c1898#Appendix_A_11" data-linktype="relative-path">&lt;11&gt;</a> be used across all computers
and networks wherever a unique identifier is required.</p><p><b>DomainName:</b> A pointer to a Unicode string that
contains the NetBIOS or FQDN of the domain.</p><p><b>DnsForestName:</b> A pointer to a null-terminated
Unicode string that contains the FQDN of the <span><a href="b5e7d25a-40b2-41c8-9611-98f53358af66#gt_fd104241-4fb3-457c-b2c4-e0c18bb20b62" data-linktype="relative-path">forest</a></span>.</p><p><b>Flags:</b> A set of bit flags in little-endian
format that describe the features and roles of the DC. A flag is TRUE (or set)
if its value is equal to 1. The value is constructed from zero or more bit
flags from the following table, with the exceptions that bit J cannot be
combined with A, B, D, E, or P; bit F cannot be combined with I; and bit K
cannot be combined with L.</p><dl>
<dd>
<table>
 <tbody><tr>
  <th><p><br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>1<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>2<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>3<br/>0</p></th>
  <th><p><br/>1</p></th>
 </tr>
 <tr>
  <td>O</td>
  <td>N</td>
  <td>M</td>
  <td>0</td>
  <td>0</td>
  <td>0</td>
  <td>0</td>
  <td>0</td>
  <td>0</td>
  <td>0</td>
  <td>0</td>
  <td>0</td>
  <td>0</td>
  <td>0</td>
  <td>T</td>
  <td>S</td>
  <td>R</td>
  <td>Q</td>
  <td>P</td>
  <td>L</td>
  <td>K</td>
  <td>J</td>
  <td>I</td>
  <td>H</td>
  <td>G</td>
  <td>F</td>
  <td>E</td>
  <td>D</td>
  <td>C</td>
  <td>B</td>
  <td>0</td>
  <td>A</td>
 </tr>
</tbody></table>
</dd>
<dd>
<p>Where the bits are defined as:</p>
</dd>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>A</td>
  <td>The DC is the domain&#39;s primary domain controller (PDC).</td>
 </tr><tr>
  <td>B</td>
  <td>The DC contains the global catalog (GC) for the forest Active Directory.</td>
 </tr><tr>
  <td>C</td>
  <td>The DC supports the Lightweight Directory Access Protocol (LDAP).</td>
 </tr><tr>
  <td>D</td>
  <td>The DC supports a directory service.</td>
 </tr><tr>
  <td>E</td>
  <td>The DC is a Kerberos Key Distribution Center (KDC).</td>
 </tr><tr>
  <td>F</td>
  <td>The DC has a network time service available but no clock hardware.</td>
 </tr><tr>
  <td>G</td>
  <td>The DC is in the closest site to the client.</td>
 </tr><tr>
  <td>H</td>
  <td>The DC has a writable directory service available.</td>
 </tr><tr>
  <td>I</td>
  <td>The DC has clock hardware and a network time service available.</td>
 </tr><tr>
  <td>J</td>
  <td>The DC is an LDAP server servicing an Application naming context (NC) ([MS-ADTS] section 3.1.1.1.5).</td>
 </tr><tr>
  <td>K</td>
  <td>The DC is a read-only domain controller (RODC).&lt;12&gt;</td>
 </tr><tr>
  <td>L</td>
  <td>The server is a writable domain controller.&lt;13&gt;</td>
 </tr><tr>
  <td>M</td>
  <td>The DC&#39;s name is a DNS name.</td>
 </tr><tr>
  <td>N</td>
  <td>The DC&#39;s domain name is a DNS name.</td>
 </tr><tr>
  <td>O</td>
  <td>The DC&#39;s forest name is a DNS name.</td>
 </tr><tr>
  <td>P</td>
  <td>The DC has an Active Directory Web Service available.&lt;14&gt;</td>
 </tr><tr>
  <td>Q</td>
  <td>The DC has a functional level of DS_BEHAVIOR_WIN2012 or later.</td>
 </tr><tr>
  <td>R</td>
  <td>The DC has a functional level of DS_BEHAVIOR_WIN2012R2 or later.</td>
 </tr><tr>
  <td>S</td>
  <td>The DC has a functional level of DS_BEHAVIOR_WIN2016 or later.</td>
 </tr><tr>
  <td>T</td>
  <td>The DC supports key list requests, as specified in [MS-KILE] section 2.2.11. If this bit is set, bit S and bit E MUST also be set.</td>
 </tr></tbody></table>
</dd>
<dd>
<p>All other bits MUST be set
to zero and MUST be ignored on receipt.</p>
</dd></dl><p><b>DcSiteName: </b>A pointer to a null-terminated
Unicode string that SHOULD<a id="Appendix_A_Target_15"></a><a aria-label="Product behavior note 15" href="0c858a52-732a-43ec-85dd-e44b357c1898#Appendix_A_15" data-linktype="relative-path">&lt;15&gt;</a> contain
the site name that is associated with the DC. When there is no associated site,
this field MUST be NULL.</p><p><b>ClientSiteName:</b> A pointer to a null-terminated
Unicode string that contains the client&#39;s site name. When there is no client
site name, this field MUST be NULL.</p></div>