IVssBackupComponents::DoSnapshotSet method (vsbackup.h)
Commits all shadow copies in this set simultaneously.
Syntax
HRESULT DoSnapshotSet(
[out] IVssAsync **ppAsync
);
Parameters
[out] ppAsync
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.
| Value | Meaning |
|---|---|
|
Successfully returned a pointer to an instance of the IVssAsync interface. See IVssAsync::QueryStatus for the valid values returned by the pHrResult parameter. |
|
The caller does not have sufficient backup privileges or is not an administrator. |
|
ppAsync does not point to a valid pointer; that is, it is NULL. |
|
The caller is out of memory or other system resources. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
The provider encountered an error that requires the user to restart the computer.
Windows Server 2003 and Windows XP: This value is not supported. |
|
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. |
|
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. |
|
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. |
|
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h) |
| Library | VssApi.lib |
See also
IVssBackupComponents::AddComponent
IVssBackupComponents::AddToSnapshotSet