<div class="content" name="PrepareShadowCopySet" uuid="5625325f-5ce4-4157-b996-bef4e63bf400"><p>The <b>PrepareShadowCopySet</b> method is invoked by the
client to ensure that the server has completed preparation for creating the <a href="0856b278-46f4-4f3e-bc06-bc382b26428b#gt_34537940-5a56-4122-b6ff-b9a4d065d066" data-linktype="relative-path">shadow copy</a> set.</p><dl>
<dd>
<div><pre> DWORD PrepareShadowCopySet(
         [in] handle_t hBinding,
         [in] GUID ShadowCopySetId,
         [in] unsigned long TimeOutInMilliseconds);
  
</pre></div>
</dd></dl><p><b>hBinding:</b> An RPC binding handle (as defined in
<a href="https://go.microsoft.com/fwlink/?LinkId=89824" data-linktype="external">[C706]</a>).</p><p><b>ShadowCopySetId:</b> The GUID of the shadow copy
set, assigned by the server.</p><p><b>TimeOutInMilliseconds:</b> The time in
milliseconds for which the server MUST wait for the shadow copy preparation
process to complete.</p><p><b>Return Values:</b> The method returns one of the
values as specified in section <a href="b45c794e-9362-42b7-80c6-7dae3382acf0" data-linktype="relative-path">2.2.4</a>. The most common
error codes are listed below.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x80070005 E_ACCESSDENIED</td>
  <td>The caller does not have permission to perform the operation.</td>
 </tr><tr>
  <td>0x80070057 E_INVALIDARG</td>
  <td>One or more arguments are invalid.</td>
 </tr><tr>
  <td>0x80042301 FSRVP_E_BAD_STATE</td>
  <td>The method call is invalid because of the state of the server.</td>
 </tr><tr>
  <td>0x00000102 FSRVP_E_WAIT_TIMEOUT</td>
  <td>The wait for shadow copy preparation operation has timed out.</td>
 </tr><tr>
  <td>0xFFFFFFFF FSRVP_E_WAIT_FAILED</td>
  <td>The wait for shadow copy preparation operation has failed.</td>
 </tr><tr>
  <td>0x80042501 FSRVP_E_SHADOWCOPYSET_ID_MISMATCH</td>
  <td>The provided ShadowCopySetId does not exist.</td>
 </tr></tbody></table>
</dd></dl><p>The server MUST look up the <b>ShadowCopySet</b> from <b>GlobalShadowCopysetTable</b>
using the index <i>ShadowCopySetId.</i> If no entry is found, the server MUST
fail the call with FSRVP_E_SHADOWCOPYSET_ID_MISMATCH.</p><p>If <b>ShadowCopySet.Status</b> is not &#34;Added<i>&#34;</i>,
the server MUST fail the call with FSRVP_E_BAD_STATE.</p><p>The server MUST stop the Message Sequence Timer specified in
section <a href="d88b9fb3-aa00-4396-91e5-f3db036d4a74" data-linktype="relative-path">3.1.2</a>.</p><p>The server MUST start the shadow copy preparation process in
the underlying <a href="0856b278-46f4-4f3e-bc06-bc382b26428b#gt_b3f0aa95-0afc-49e3-a5d5-aa465c3bc385" data-linktype="relative-path">shadow copy
utility</a> and MUST wait for the completion of the operation.</p><p>If the wait for the preparation operation fails, the server
MUST start the Message Sequence Timer as specified in section 3.1.2 with a
timeout value of 180 seconds, and fail the call with FSRVP_E_WAIT_FAILED.</p><p>If the preparation operation for does not complete within <b>TimeOutInMilliseconds</b>,
the server MUST start the Message Sequence Timer as specified in section 3.1.2
with a timeout value of 180 seconds, and return FSRVP_E_WAIT_TIMEOUT.</p><p>If the preparation operation returns an error, the server
MUST start the Message Sequence Timer as specified in section 3.1.2 with a
timeout value of 180 seconds, and fail the call with the same error code.</p><p>If the shadow copy preparation operation completes within <b>TimeOutInMilliseconds,</b>
the server MUST start the Message Sequence Timer as specified in section 3.1.2
with a timeout value of 1800 seconds, and return ZERO to the caller.</p></div>