Export (0) Print
Expand All

IVssBackupComponentsEx3::AddSnapshotToRecoverySet method

Specifies the volumes to be included in a LUN resynchronization operation. This method is supported only on Windows server operating systems.

Syntax


HRESULT AddSnapshotToRecoverySet(
  [in]            VSS_ID snapshotId,
  [in]            DWORD dwFlags,
  [in, optional]  VSS_PWSZ pwszDestinationVolume
);

Parameters

snapshotId [in]

The identifier of the shadow copy that was returned by the IVssBackupComponents::AddToSnapshotSet method during backup. This parameter is required and cannot be GUID_NULL.

dwFlags [in]

This parameter is reserved and must be zero.

pwszDestinationVolume [in, optional]

This parameter is optional and can be NULL. A value of NULL means that the contents of the shadow copy volume are to be copied back to the original volume. VSS identifies the original volume by the VDS_LUN_INFO information in the Backup Components Document.

Return value

The following are the valid return codes for this method.

ValueMeaning
S_OK
0x00000000L

The operation was successful.

VSS_E_BAD_STATE
0x80042301L

Either there is no hardware provider that supports the operation, or the requester did not successfully add any volumes to the recovery set.

VSS_E_LEGACY_PROVIDER
0x800423F7L

This version of the hardware provider does not support this operation.

VSS_E_OBJECT_NOT_FOUND
0x80042308L

The snapshotId parameter specifies a shadow copy that the hardware provider does not own.

VSS_E_RESYNC_IN_PROGRESS
0x800423FFL

Another LUN resynchronization operation is already in progress.

VSS_E_SNAPSHOT_NOT_IN_SET
0x8004232BL

The snapshotId parameter specifies a shadow copy that does not exist in the Backup Components Document.

VSS_E_VOLUME_NOT_SUPPORTED
0x8004230CL

LUN resynchronization is not supported on this volume, because it is a dynamic volume, because the destination disk does not have a unique page 83 storage identifier, because the specified volume does not reside on a LUN managed by a VSS hardware provider, or because the destination disk is a cluster quorum disk.

 

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:
© 2014 Microsoft