Skip to content

Latest commit

 

History

History
227 lines (196 loc) · 5.03 KB

nf-vsbackup-ivssbackupcomponents-reverttosnapshot.md

File metadata and controls

227 lines (196 loc) · 5.03 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:vsbackup.IVssBackupComponents.RevertToSnapshot
IVssBackupComponents::RevertToSnapshot (vsbackup.h)
Reverts a volume to a previous shadow copy. (IVssBackupComponents.RevertToSnapshot)
IVssBackupComponents interface [VSS]
RevertToSnapshot method
IVssBackupComponents.RevertToSnapshot
IVssBackupComponents::RevertToSnapshot
RevertToSnapshot
RevertToSnapshot method [VSS]
RevertToSnapshot method [VSS]
IVssBackupComponents interface
_win32_ivssbackupcomponents_reverttosnapshot
base.ivssbackupcomponents_reverttosnapshot
vsbackup/IVssBackupComponents::RevertToSnapshot
base\ivssbackupcomponents_reverttosnapshot.htm
base
9976195e-3448-4b0e-82b2-1ae061c75b17
12/05/2018
IVssBackupComponents interface [VSS],RevertToSnapshot method, IVssBackupComponents.RevertToSnapshot, IVssBackupComponents::RevertToSnapshot, RevertToSnapshot, RevertToSnapshot method [VSS], RevertToSnapshot method [VSS],IVssBackupComponents interface, _win32_ivssbackupcomponents_reverttosnapshot, base.ivssbackupcomponents_reverttosnapshot, vsbackup/IVssBackupComponents::RevertToSnapshot
vsbackup.h
VsBackup.h, Vss.h, VsWriter.h
Windows
None supported
Windows Server 2008, Windows Server 2003 with SP1 [desktop apps only]
VssApi.lib
Windows
19H1
IVssBackupComponents::RevertToSnapshot
vsbackup/IVssBackupComponents::RevertToSnapshot
c++
APIRef
kbSyntax
COM
VssApi.lib
VssApi.dll
IVssBackupComponents.RevertToSnapshot

IVssBackupComponents::RevertToSnapshot

-description

The RevertToSnapshot method reverts a volume to a previous shadow copy. Only shadow copies created with persistent contexts (VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS, or VSS_CTX_NAS_ROLLBACK) are supported.

Note  This method is only supported on Windows Server operating systems.
 

-parameters

-param SnapshotId [in]

VSS_ID of the shadow copy to revert.

-param bForceDismount [in]

If this parameter is TRUE, the volume will be dismounted and reverted even if the volume is in use.

-returns

This method can return one of these values.

Value Meaning
S_OK
The operation was successful.
E_ACCESSDENIED
The calling process has insufficient privileges.
E_FAIL
There is an internal error.
E_INVALIDARG
One of the parameters passed is not valid.
E_NOTIMPL
The provider for the volume does not support revert operations.
E_OUTOFMEMORY
The caller is out of memory or other system resources.
VSS_E_OBJECT_NOT_FOUND
The SnapshotId parameter is not a valid shadow copy.
VSS_E_PROVIDER_NOT_REGISTERED
The provider was not found.
VSS_E_REVERT_IN_PROGRESS
The volume already has a revert in process.
VSS_E_UNSUPPORTED_CONTEXT
Revert is only supported for persistent shadow copies.
VSS_E_VOLUME_IN_USE
The bForceDismount parameter was FALSE, and the volume could not be locked.
VSS_E_VOLUME_NOT_SUPPORTED
Revert is not supported on this volume.

-remarks

This operation cannot be canceled, or undone once completed. If the computer is rebooted during the revert operation, the revert process will continue when the system is restarted.

-see-also

IVssBackupComponents

IVssBackupComponents::QueryRevertStatus