nf-vsbackup-ivssbackupcomponents-queryrevertstatus.md

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.QueryRevertStatus	IVssBackupComponents::QueryRevertStatus (vsbackup.h)	Returns an IVssAsync interface pointer that can be used to determine the status of the revert operation. (IVssBackupComponents.QueryRevertStatus)	IVssBackupComponents interface [VSS] QueryRevertStatus method IVssBackupComponents.QueryRevertStatus IVssBackupComponents::QueryRevertStatus QueryRevertStatus QueryRevertStatus method [VSS] QueryRevertStatus method [VSS] IVssBackupComponents interface _win32_ivssbackupcomponents_queryrevertstatus base.ivssbackupcomponents_queryrevertstatus vsbackup/IVssBackupComponents::QueryRevertStatus	base\ivssbackupcomponents_queryrevertstatus.htm	base	f2e97723-98cb-401c-ab35-20c004f0a73d	12/05/2018	IVssBackupComponents interface [VSS],QueryRevertStatus method, IVssBackupComponents.QueryRevertStatus, IVssBackupComponents::QueryRevertStatus, QueryRevertStatus, QueryRevertStatus method [VSS], QueryRevertStatus method [VSS],IVssBackupComponents interface, _win32_ivssbackupcomponents_queryrevertstatus, base.ivssbackupcomponents_queryrevertstatus, vsbackup/IVssBackupComponents::QueryRevertStatus	vsbackup.h	VsBackup.h, Vss.h, VsWriter.h	Windows	Windows Vista with SP1 [desktop apps only]	Windows Server 2008, Windows Server 2003 with SP1 [desktop apps only]										VssApi.lib			Windows			19H1	IVssBackupComponents::QueryRevertStatus vsbackup/IVssBackupComponents::QueryRevertStatus	c++	APIRef kbSyntax	COM	VssApi.lib VssApi.dll	IVssBackupComponents.QueryRevertStatus

IVssBackupComponents::QueryRevertStatus

-description

The QueryRevertStatus method returns an IVssAsync interface pointer that can be used to determine the status of the revert operation.

-parameters

-param pwszVolume [in]

Null-terminated wide character string containing the name of the volume. The name must be in one of the following formats and must include a trailing backslash (\):

• The path of a mounted folder, for example, Y:\MountX\
• A drive letter, for example, D:\
• A volume GUID path of the form \\?\Volume{GUID}\ (where GUID identifies the volume)

-param ppAsync [out]

Pointer to a location that will receive an IVssAsync interface pointer that can be used to retrieve the status of the revert process. When the operation is complete, the caller must release the interface pointer by calling the IUnknown::Release method.

-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.
E_POINTER	One of the required pointer parameters is NULL.
VSS_E_OBJECT_NOT_FOUND	The pwszVolume parameter is not a valid volume.
VSS_E_VOLUME_NOT_SUPPORTED	Revert is not supported on this volume.

-remarks

The revert operation will continue even if the computer is rebooted, and cannot be canceled or undone, except by restoring a backup created using another method. The QueryStatus method on the returned
IVssAsync interface cannot return VSS_S_ASYNC_CANCELLED as the revert operation cannot be canceled after it has started.

-see-also

IVssAsync

IVssBackupComponents

IVssBackupComponents::RevertToSnapshot