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. |
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 E_INVALIDARG.
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 global CurrentContext to zero, and return ZERO to the caller.