<div class="content" name="NetrDfsManagerReportSiteInfo" uuid="393ed753-0a8f-457c-a7aa-f0692d329e23"><p>The NetrDfsManagerReportSiteInfo method obtains a list of
names that SHOULD<a id="Appendix_A_Target_166"></a><a aria-label="Product behavior note 166" href="ebb74ff2-abb1-4e1b-a76a-563a5cbbea9a#Appendix_A_166" data-linktype="relative-path">&lt;166&gt;</a> correspond to the Active
Directory <a href="1709f6a7-efb8-4ded-b7ae-5cee9ee36320#gt_8abdc986-5679-42d9-ad76-b11eb5a0daba" data-linktype="relative-path">sites</a> covered
by the specified server. An implementation MAY<a id="Appendix_A_Target_167"></a><a aria-label="Product behavior note 167" href="ebb74ff2-abb1-4e1b-a76a-563a5cbbea9a#Appendix_A_167" data-linktype="relative-path">&lt;167&gt;</a> choose
to support this method.</p><dl>
<dd>
<div><pre> NET_API_STATUS NetrDfsManagerReportSiteInfo(
   [in, string, unique] SRVSVC_HANDLE ServerName,
   [in, out, unique] LPDFS_SITELIST_INFO* ppSiteInfo
 );
</pre></div>
</dd></dl><p><b>ServerName: </b>An <a href="5f8329ee-1965-4ea1-ad35-3b29fbb63232" data-linktype="relative-path">SRVSVC_HANDLE (section 2.2.1.1)</a>
pointer that identifies the <a href="1709f6a7-efb8-4ded-b7ae-5cee9ee36320#gt_434b0234-e970-4e8c-bdfa-e16a30d96703" data-linktype="relative-path">server</a>.
The <a href="1709f6a7-efb8-4ded-b7ae-5cee9ee36320#gt_60e0e1fa-66fe-41e1-b5e3-ceab97e53506" data-linktype="relative-path">client</a> MUST map this
structure to an RPC binding handle (see <a href="https://go.microsoft.com/fwlink/?LinkId=89824" data-linktype="external">[C706]</a> sections 4.3.5
and 5.1.5.2).</p><p><b>ppSiteInfo: </b>A pointer to an <a href="b7f93021-f7fe-4c51-a351-293909c6ced9" data-linktype="relative-path">LPDFS_SITELIST_INFO</a> structure,
which in turn points to the location of a DFS_SITELIST_INFO structure in which
the information is returned.</p><p><b>Return Values: </b>The method returns 0x00000000
(NERR_Success) to indicate success; otherwise, it returns a nonzero error code.
The method can take any specific error code value, as specified in <a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a>
section <a href="../ms-erref/18d8fbe8-a967-4f1c-ae50-99ca8e491d2d" data-linktype="relative-path">2.2</a>.</p><p>The <i>ppSiteInfo</i> parameter is a pointer to a
LPDFS_SITELIST_INFO member, which in turn points to the location of a
DFS_SITELIST_INFO structure in which the information is returned. That
structure has a <b>cSites</b> member that the server SHOULD set to the number
of sites returned. The information about the sites themselves MUST be returned
in the <b>Site</b> member, which is an array of <a href="6882b4d9-6527-4eef-8ac0-fe3de7b4494f" data-linktype="relative-path">DFS_SITENAME_INFO</a>
structures. The sites the server returns are implementation-specific.<a id="Appendix_A_Target_168"></a><a aria-label="Product behavior note 168" href="ebb74ff2-abb1-4e1b-a76a-563a5cbbea9a#Appendix_A_168" data-linktype="relative-path">&lt;168&gt;</a></p><p>The server MAY<a id="Appendix_A_Target_169"></a><a aria-label="Product behavior note 169" href="ebb74ff2-abb1-4e1b-a76a-563a5cbbea9a#Appendix_A_169" data-linktype="relative-path">&lt;169&gt;</a>
enforce security measures to verify that the caller has the required
permissions to execute this call. If the server enforces these security
measures and the caller does not have the required credentials, the server
SHOULD<a id="Appendix_A_Target_170"></a><a aria-label="Product behavior note 170" href="ebb74ff2-abb1-4e1b-a76a-563a5cbbea9a#Appendix_A_170" data-linktype="relative-path">&lt;170&gt;</a> fail the call.</p></div>