3.1.4.7 RecoveryCompleteShadowCopySet (Opnum 6)

The RecoveryCompleteShadowCopySet method is invoked by the client to indicate to the server that the data associated with the file shares in a shadow copy set have been recovered by the VSS writers.

 DWORD RecoveryCompleteShadowCopySet(
         [in] handle_t hBinding,
         [in] GUID ShadowCopySetId);
  

hBinding:  An RPC binding handle (as defined in [C706]).

ShadowCopySetId: The GUID of the shadow copy set.

Return Values: The method returns one of the values as specified in section 2.2.4. The most common error codes are listed in the following table:

Return value/code

Description

0x00000000

ZERO

The operation completed successfully.

0x80070005

E_ACCESSDENIED

The caller does not have the permissions to perform the operation.

0x80070057

E_INVALIDARG

One or more arguments are invalid.

0x80042301

FSRVP_E_BAD_STATE

The method call is invalid because of the server's state.

0x80042501

FSRVP_E_SHADOWCOPYSET_ID_MISMATCH

The provided ShadowCopySetId does not exist.

The server MUST look up the ShadowCopySet from GlobalShadowCopysetTable using the index ShadowCopySetId. If no shadow copy set is found, the server MUST fail the call with FSRVP_E_SHADOWCOPYSET_ID_MISMATCH.

If ShadowCopySet.Status is not "Exposed", the server MUST fail the call with FSRVP_E_BAD_STATE.

The server MUST stop the Message Sequence Timer specified in section 3.1.2.

If ATTR_NO_AUTO_RECOVERY bit in ShadowCopySet.Context is not set, for each ShadowCopy in ShadowCopySet.ShadowCopyList, the server MUST set the shadow copy identified by ShadowCopy.ShadowCopyId to read-only.

The server MUST update ShadowCopySet.Status to "Recovered", set ContextSet to FALSE, set ShadowCopyClientAddress to NULL, and return ZERO to the caller.

Show: