<div class="content"><p>This method is not used by <a href="2e457199-2dc1-46c3-8aa6-b2d8e016f95c#gt_20f21413-875c-4ebf-9913-a3282fbb779f" data-linktype="relative-path">FRS</a>. </p><dl>
<dd>
<div><pre> unsigned long NtFrsApi_Rpc_IsPathReplicated(
   [in] handle_t Handle,
   [in, string, unique] PWCHAR Path,
   [in] unsigned long ReplicaSetTypeOfInterest,
   [out] unsigned long* Replicated,
   [out] unsigned long* Primary,
   [out] unsigned long* Root,
   [out] GUID* ReplicaSetGuid
 );
</pre></div>
</dd></dl><p><b>Handle: </b>Binding handle obtained when the <a href="2e457199-2dc1-46c3-8aa6-b2d8e016f95c#gt_7b0ee975-d1b4-4a39-865d-d13e6c96aa76" data-linktype="relative-path">partner</a> authenticates with
the file replication service (FRS).</p><p><b>Path: </b>Local path being queried.<a id="Appendix_A_Target_63"></a><a aria-label="Product behavior note 63" href="d18cc589-677e-4133-97e5-113641792c5e#Appendix_A_63" data-linktype="relative-path">&lt;63&gt;</a></p><p><b>ReplicaSetTypeOfInterest: </b>Replica set type
identified by the path. The value MUST be 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>
  <p>0x00000000</p>
  </td>
  <td>
  <p>Indicates any <a href="2e457199-2dc1-46c3-8aa6-b2d8e016f95c#gt_6cef9d9c-c366-490a-8e4e-a350688731ca" data-linktype="relative-path">replica set</a>.</p>
  </td>
 </tr><tr>
  <td>
  <p>FRS_RSTYPE_ENTERPRISE_SYSVOL</p>
  <p>0x00000001</p>
  </td>
  <td>
  <p>Indicates the replica set for the enterprise <a href="2e457199-2dc1-46c3-8aa6-b2d8e016f95c#gt_d3283b03-3828-49a7-ae15-9b65f86482e1" data-linktype="relative-path">system volume (SYSVOL)</a>.</p>
  </td>
 </tr><tr>
  <td>
  <p>FRS_RSTYPE_DOMAIN_SYSVOL</p>
  <p>0x00000002</p>
  </td>
  <td>
  <p>Indicates the replica set for the domain SYSVOL.</p>
  </td>
 </tr><tr>
  <td>
  <p>FRS_RSTYPE_DFS</p>
  <p>0x00000003</p>
  </td>
  <td>
  <p>Indicates the replica set for the <a href="2e457199-2dc1-46c3-8aa6-b2d8e016f95c#gt_0b8086c9-d025-45b8-bf09-6b5eca72713e" data-linktype="relative-path">distributed file system</a>,
  as specified in <a href="../ms-dfsnm/95a506a8-cae6-4c42-b19d-9c1ed1223979" data-linktype="relative-path">[MS-DFSNM]</a>.</p>
  </td>
 </tr><tr>
  <td>
  <p>FRS_RSTYPE_OTHER</p>
  <p>0x00000004</p>
  </td>
  <td>
  <p>Indicates none of the previous types.</p>
  </td>
 </tr></tbody></table>
</dd></dl><p><b>Replicated: </b>Boolean value that indicates if
the replica set is replicated by the <a href="2e457199-2dc1-46c3-8aa6-b2d8e016f95c#gt_76a05049-3531-4abd-aec8-30e19954b4bd" data-linktype="relative-path">domain controller (DC)</a>. The
value MUST be 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>
  <p>FALSE</p>
  <p>0x00000000</p>
  </td>
  <td>
  <p>The <i>Path</i> parameter is not part of a replica set
  of the type specified in <i>ReplicaSetTypeOfInterest</i>. If this value is
  returned, <i>Primary</i>, <i>Root</i>, and <i>ReplicaSetGuid</i> are set to
  NULL.</p>
  </td>
 </tr><tr>
  <td>
  <p>TRUE</p>
  <p>0x00000001</p>
  </td>
  <td>
  <p>The <i>Path</i> parameter is part of a replica set of
  the type specified in <i>ReplicaSetTypeOfInterest</i>.</p>
  </td>
 </tr></tbody></table>
</dd></dl><p><b>Primary: </b>Indicates if the computer is the
first computer for the replica set for <a href="2e457199-2dc1-46c3-8aa6-b2d8e016f95c#gt_46a2ebd1-502d-46d9-a64a-677077aaf78c" data-linktype="relative-path">initial sync</a>. The value
MUST be 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>
  <p>0x00000000</p>
  </td>
  <td>
  <p>Current computer is not the primary computer for the
  matching replica set.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x00000001</p>
  </td>
  <td>
  <p>Current computer is the primary computer for the
  matching replica set.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x00000002</p>
  </td>
  <td>
  <p>Matching replica set does not have a primary computer.</p>
  </td>
 </tr></tbody></table>
</dd></dl><p><b>Root: </b>A Boolean value that indicates if the
path is the <a href="2e457199-2dc1-46c3-8aa6-b2d8e016f95c#gt_5416e3c0-0a8f-46e1-b583-40ba4264d894" data-linktype="relative-path">replica tree
root</a> for the replica set. The value MUST be 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>
  <p>FALSE</p>
  <p>0x00000000</p>
  </td>
  <td>
  <p>The <i>Path</i> parameter is not the replica tree root
  for the matching replica set.</p>
  </td>
 </tr><tr>
  <td>
  <p>TRUE</p>
  <p>0x00000001</p>
  </td>
  <td>
  <p>The <i>Path</i> parameter is the replica tree root for
  the matching replica set.</p>
  </td>
 </tr></tbody></table>
</dd></dl><p><b>ReplicaSetGuid:</b> <a href="2e457199-2dc1-46c3-8aa6-b2d8e016f95c#gt_f49694cc-c350-462d-ab8e-816f0103c6c1" data-linktype="relative-path">GUID</a> for the matching
replica set.</p><p><b>Return Values:</b> The method MUST return 0 on
success or a nonzero error code on failure. All nonzero values MUST be treated
as equivalent failures unless otherwise specified.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>0x00000000</p>
  <p>ERROR_SUCCESS</p>
  </td>
  <td>
  <p>The method completed successfully.</p>
  </td>
 </tr></tbody></table>
</dd></dl><p><b>Exceptions Thrown:</b> No exceptions are thrown beyond
those thrown by the underlying RPC protocol <a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a>.</p><p><b>Validating the NtFrsApi_Rpc IsPathReplicated request: </b>The
server must validate the NtFrsApi_Rpc IsPathReplicated request by performing
the following checks. </p><ul><li><p><span><span> 
</span></span>If <b>IsPathReplicatedCheckEnabled</b> is set to
&#34;None&#34;, the server MUST fail the call with an implementation-specific
value.</p>
</li><li><p><span><span> 
</span></span>If <b>IsPathReplicatedCheckEnabled</b> is set to &#34;Disabled&#34;,
the server MUST process the request without performing an access check.</p>
</li><li><p><span><span> 
</span></span>If <b>IsPathReplicatedCheckEnabled</b> is set to
&#34;Enabled&#34;, the server MUST check whether the calling client is
authorized to perform that function. If the calling client is not authorized to
perform that function, the server MUST return ERROR_NOT_AUTHENTICATED.</p>
<ul><li><p><span><span>  </span></span>If <b>ReplicatedPathAccessRequired</b>
is set to &#34;None&#34;, the server MUST fail the call with an
implementation-specific value.</p>
</li><li><p><span><span>  </span></span>If <b>ReplicatedPathAccessRequired</b>
is set to &#34;Read&#34;, the server MUST check whether the caller has read
access. If the caller does not have read access, the server MUST return
FRS_ERR_INSUFFICIENT_PRIV.</p>
</li><li><p><span><span>  </span></span>If <b>ReplicatedPathAccessRequired</b>
is set to &#34;Write&#34;, the server MUST check whether the caller has write
access. If the caller does not have write access, the server MUST return
FRS_ERR_INSUFFICIENT_PRIV.</p>
</li></ul></li><li><p><span><span> 
</span></span>If the server is not able to verify the passed in parameters,
then it MUST ignore the failure and succeed the call.</p>
</li></ul><p><b>Actions Triggered: </b>The NtFrsApi_Rpc_IsPathReplicated
method MUST return a value that specifies if a Path is part of a replica set of
the type specified in the ReplicaSetTypeOfInterest parameter. The method is not
used in server-to-server interoperation. </p></div>