Export (0) Print
Expand All
1 out of 2 rated this helpful - Rate this topic

IVssBackupComponents::DoSnapshotSet method

Commits all shadow copies in this set simultaneously.

Syntax


HRESULT DoSnapshotSet(
  [out]  IVssAsync **ppAsync
);

Parameters

ppAsync [out]

A doubly indirect pointer to the required IVssAsync asynchronous interface. This is used to query the method execution state and to retrieve the final error code.

Return value

The following are the valid return codes for this method. These error codes may be returned from this method, or from the QueryStatus method on the IVssAsync interface returned in the ppAsync parameter.

ValueMeaning
S_OK

Successfully returned a pointer to an instance of the IVssAsync interface. See IVssAsync::QueryStatus for the valid values returned by the pHrResult parameter.

E_ACCESSDENIED

The caller does not have sufficient backup privileges or is not an administrator.

E_INVALIDARG

ppAsyncdoes not point to a valid pointer; that is, it is NULL.

E_OUTOFMEMORY

The caller is out of memory or other system resources.

VSS_E_BAD_STATE

The backup components object has not been initialized or the prerequisite calls for a given shadow copy context have not been made prior to calling DoSnapshotSet.

VSS_E_INSUFFICIENT_STORAGE

The system or provider has insufficient storage space. If possible delete any old or unnecessary persistent shadow copies and try again. This error code is only returned via the QueryStatus method on the IVssAsync interface returned in the ppAsync parameter.

VSS_E_FLUSH_WRITES_TIMEOUT

The system was unable to flush I/O writes. This can be a transient problem. It is recommended to wait ten minutes and try again, up to three times.

VSS_E_HOLD_WRITES_TIMEOUT

The system was unable to hold I/O writes. This can be a transient problem. It is recommended to wait ten minutes and try again, up to three times.

VSS_E_NESTED_VOLUME_LIMIT

The specified volume is nested too deeply to participate in the VSS operation.

Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP:  This return code is not supported.

VSS_E_PROVIDER_VETO

The provider was unable to perform the request at this time. This can be a transient problem. It is recommended to wait ten minutes and try again, up to three times. This error code is only returned via the QueryStatus method on the IVssAsync interface returned in the ppAsync parameter.

VSS_E_REBOOT_REQUIRED

The provider encountered an error that requires the user to restart the computer.

Windows Server 2003 and Windows XP:  This value is not supported.

VSS_E_TRANSACTION_FREEZE_TIMEOUT

The system was unable to freeze the Distributed Transaction Coordinator (DTC) or the Kernel Transaction Manager (KTM).

Windows Server 2003 and Windows XP:  This value is not supported.

VSS_E_TRANSACTION_THAW_TIMEOUT

The system was unable to thaw the Distributed Transaction Coordinator (DTC) or the Kernel Transaction Manager (KTM).

Windows Server 2003 and Windows XP:  This value is not supported.

VSS_E_UNEXPECTED

Unexpected error. The error code is logged in the error log file. For more information, see Event and Error Handling Under VSS.

Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP:  This value is not supported until Windows Server 2008 R2 and Windows 7. E_UNEXPECTED is used instead.

VSS_E_UNEXPECTED_PROVIDER_ERROR

The provider returned an unexpected error code. This can be a transient problem. It is recommended to wait ten minutes and try again, up to three times. This error code is only returned via the QueryStatus method on the IVssAsync interface returned in the ppAsync parameter.

 

Remarks

The caller is responsible for releasing the IVssAsync interface.

This method cannot be called for a virtual hard disk (VHD) that is nested inside another VHD.

Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP:  VHDs are not supported.

For information on how to use IVssBackupComponents::DoSnapshotSet to create a standard backup shadow copy, see Overview of Pre-Backup Tasks and Simple Shadow Copy Creation for Backup. For information on how the method is used under different VSS contexts, see Implementation Details for Creating Shadow Copies.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

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

Library

VssApi.lib

See also

IVssBackupComponents::AddToSnapshotSet
IVssBackupComponents::StartSnapshotSet
IVssBackupComponents::AddComponent
IVssBackupComponents::PrepareForBackup
IVssBackupComponents
IVssAsync

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.