<div class="content" name="NtFrsApi_Rpc_IsPathReplicated" uuid="536d4f02-0687-46b1-ba96-9fb4799b0bfd"><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>0x00000000</td>
  <td>Indicates any replica set.</td>
 </tr><tr>
  <td>FRS_RSTYPE_ENTERPRISE_SYSVOL 0x00000001</td>
  <td>Indicates the replica set for the enterprise system volume (SYSVOL).</td>
 </tr><tr>
  <td>FRS_RSTYPE_DOMAIN_SYSVOL 0x00000002</td>
  <td>Indicates the replica set for the domain SYSVOL.</td>
 </tr><tr>
  <td>FRS_RSTYPE_DFS 0x00000003</td>
  <td>Indicates the replica set for the distributed file system, as specified in [MS-DFSNM].</td>
 </tr><tr>
  <td>FRS_RSTYPE_OTHER 0x00000004</td>
  <td>Indicates none of the previous types.</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>FALSE 0x00000000</td>
  <td>The Path parameter is not part of a replica set of the type specified in ReplicaSetTypeOfInterest. If this value is returned, Primary, Root, and ReplicaSetGuid are set to NULL.</td>
 </tr><tr>
  <td>TRUE 0x00000001</td>
  <td>The Path parameter is part of a replica set of the type specified in ReplicaSetTypeOfInterest.</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>0x00000000</td>
  <td>Current computer is not the primary computer for the matching replica set.</td>
 </tr><tr>
  <td>0x00000001</td>
  <td>Current computer is the primary computer for the matching replica set.</td>
 </tr><tr>
  <td>0x00000002</td>
  <td>Matching replica set does not have a primary computer.</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>FALSE 0x00000000</td>
  <td>The Path parameter is not the replica tree root for the matching replica set.</td>
 </tr><tr>
  <td>TRUE 0x00000001</td>
  <td>The Path parameter is the replica tree root for the matching replica set.</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>0x00000000 ERROR_SUCCESS</td>
  <td>The method completed successfully.</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>