IVssBackupComponents::RevertToSnapshot-Methode (vsbackup.h)

  • Artikel

Die RevertToSnapshot-Methode stellt ein Volume auf eine vorherige Schattenkopie zurück. Es werden nur Schattenkopien unterstützt, die mit persistenten Kontexten (VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS oder VSS_CTX_NAS_ROLLBACK) erstellt wurden.

Hinweis Diese Methode wird nur unter Windows Server-Betriebssystemen unterstützt.
 

Syntax

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

Parameter

[in] SnapshotId

VSS_ID der Schattenkopie in rückgängig machen.

[in] bForceDismount

Wenn dieser Parameter TRUE ist, wird die Bereitstellung des Volumes aufgehoben und auch dann wiederhergestellt, wenn das Volume verwendet wird.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert Bedeutung
S_OK
 Der Vorgang wurde durchgeführt.
E_ACCESSDENIED
 Der aufrufende Prozess verfügt über unzureichende Berechtigungen.
E_FAIL
 Es liegt ein interner Fehler vor.
E_INVALIDARG
 Einer der übergebenen Parameter ist ungültig.
E_NOTIMPL
 Der Anbieter für das Volume unterstützt keine rückgängig machen Vorgänge.
E_OUTOFMEMORY
 Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_OBJECT_NOT_FOUND
 Der SnapshotId-Parameter ist keine gültige Schattenkopie.
VSS_E_PROVIDER_NOT_REGISTERED
 Der Anbieter wurde nicht gefunden.
VSS_E_REVERT_IN_PROGRESS
 Das Volume verfügt bereits über eine rückgängig machen.
VSS_E_UNSUPPORTED_CONTEXT
 Wiederherstellen wird nur für persistente Schattenkopien unterstützt.
VSS_E_VOLUME_IN_USE
 Der bForceDismount-Parameter war FALSE, und das Volume konnte nicht gesperrt werden.
VSS_E_VOLUME_NOT_SUPPORTED
 Die Wiederherstellung wird auf diesem Volume nicht unterstützt.

Hinweise

Dieser Vorgang kann nicht abgebrochen oder nach Abschluss rückgängig werden. Wenn der Computer während des rückgängig machen-Vorgangs neu gestartet wird, wird der rückgängig machen Prozess fortgesetzt, wenn das System neu gestartet wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2008, Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

IVssBackupComponents

IVssBackupComponents::QueryRevertStatus