IVssBackupComponentsEx3::RecoverSet method (vsbackup.h)

  • Article

Initiates a LUN resynchronization operation. This method is supported only on Windows server operating systems.

Syntax

HRESULT RecoverSet(
  [in]  DWORD     dwFlags,
  [out] IVssAsync **ppAsync
);

Parameters

[in] dwFlags

A bitmask of VSS_RECOVERY_OPTIONS flags that specify how the resynchronization is to be performed.

[out] ppAsync

A pointer to a variable that receives an IVssAsync interface pointer that can be used to retrieve the status of the LUN resynchronization operation. When the operation is complete, the caller must release the interface pointer by calling the IUnknown::Release method.

Return value

This method can return one of these values.

Return code/value Description
S_OK
0x00000000L
 The operation was successfully completed.
E_NOTIMPL
0x80000001L
 The provider for the volume does not support LUN resynchronization.
VSS_E_BAD_STATE
0x80042301L
 Possible reasons for this return value include:
  • There is no hardware provider that supports the operation.
  • The requester did not successfully add any volumes to the recovery set.
  • The method was called in WinPE or in Safe mode.
  • The caller did not call the IVssBackupComponents::InitializeForRestore method before calling this method.
VSS_E_LEGACY_PROVIDER
0x800423F7L
 This version of the hardware provider does not support this operation.
VSS_E_PROVIDER_VETO
0x80042306L
 An unexpected provider error occurred. If this error code is returned, the error must be described in an entry in the application event log, giving the user information on how to resolve the problem.
VSS_E_UNSELECTED_VOLUME
0x8004232AL
 The resynchronization destination contained a volume that was not explicitly included.
VSS_E_CANNOT_REVERT_DISKID
0x800423FEL
 The MBR signature or GPT ID for one or more disks could not be set to the intended value. Check the Application event log for more information.

Remarks

At the end of the resynchronization operation, by default the newly resychronized LUN will have the same disk signature that the destination LUN had before the resynchronization.

This method cannot be called in WinPE, and it cannot be called in Safe mode. Before calling this method, the caller must call IVssBackupComponents::InitializeForRestore to prepare for the resynchronization.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)

See also

IVssBackupComponentsEx3