Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
RecoverSet Method
Collapse the table of content
Expand the table of content

IVssBackupComponentsEx3::RecoverSet method

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

dwFlags [in]

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

ppAsync [out]

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/valueDescription
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

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

VsBackup.h (include VsBackup.h, Vss.h, or VsWriter.h)

See also

IVssBackupComponentsEx3

 

 

Community Additions

ADD
Show:
© 2015 Microsoft