Metodo IVssBackupComponents::RevertToSnapshot (vsbackup.h)

Articolo
08/27/2023

Il metodo RevertToSnapshot ripristina un volume in una copia shadow precedente. Sono supportate solo le copie shadow create con contesti persistenti (VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS o VSS_CTX_NAS_ROLLBACK).

Nota Questo metodo è supportato solo nei sistemi operativi Windows Server.

Sintassi

HRESULT RevertToSnapshot(
  [in] VSS_ID SnapshotId,
  [in] BOOL   bForceDismount
);

Parametri

[in] SnapshotId

VSS_ID della copia shadow da ripristinare.

[in] bForceDismount

Se questo parametro è TRUE, il volume verrà smontato e ripristinato anche se il volume è in uso.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	L'operazione è stata completata.
E_ACCESSDENIED	Il processo chiamante dispone di privilegi insufficienti.
E_FAIL	Si è verificato un errore interno.
E_INVALIDARG	Uno dei parametri passati non è valido.
E_NOTIMPL	Il provider per il volume non supporta le operazioni di ripristino.
E_OUTOFMEMORY	Il chiamante non è in memoria o in altre risorse di sistema.
VSS_E_OBJECT_NOT_FOUND	Il parametro SnapshotId non è una copia shadow valida.
VSS_E_PROVIDER_NOT_REGISTERED	Il provider non è stato trovato.
VSS_E_REVERT_IN_PROGRESS	Il volume ha già un processo di ripristino.
VSS_E_UNSUPPORTED_CONTEXT	Il ripristino è supportato solo per le copie shadow persistenti.
VSS_E_VOLUME_IN_USE	Il parametro bForceDismount è FALSE e non è stato possibile bloccare il volume.
VSS_E_VOLUME_NOT_SUPPORTED	Il ripristino non è supportato in questo volume.

Commenti

Questa operazione non può essere annullata o annullata al termine. Se il computer viene riavviato durante l'operazione di ripristino, il processo di ripristino continuerà al riavvio del sistema.

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008, Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Libreria	VssApi.lib

Vedi anche

IVssBackupComponents

IVssBackupComponents::QueryRevertStatus

Condividi tramite