IVssBackupComponents::BreakSnapshotSet-Methode (vsbackup.h)

  • Artikel

Die BreakSnapshotSet-Methode bewirkt, dass das Vorhandensein eines Schattenkopiensatzes von VSS "vergessen" wird.

Syntax

HRESULT BreakSnapshotSet(
  [in] VSS_ID SnapshotSetId
);

Parameter

[in] SnapshotSetId

Bezeichner des Schattenkopiersatzes.

Rückgabewert

Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.

Wert Bedeutung
S_OK
 Der Schattenkopiesatz wurde erfolgreich beschädigt.
E_ACCESSDENIED
 Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator.
E_INVALIDARG
 Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
 Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_OBJECT_NOT_FOUND
 Die angegebene Schattenkopie ist nicht vorhanden.
VSS_E_PROVIDER_VETO
 Die Schattenkopie wurde von einem Softwareanbieter erstellt und kann nicht beschädigt werden.
VSS_E_UNEXPECTED
 Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet.

Hinweise

BreakSnapshotSet kann nur für Schattenkopien verwendet werden, die von einem Hardwareschattenkopieanbieter erstellt wurden. Diese Methode erstellt diese Schattenkopien zu regulären Volumes.

Schattenkopien von Volumes, die mit BreakSnapshotSet "broken" sind, müssen unabhängig von VSS als eigenständige Volumes verwaltet werden. Weitere Informationen finden Sie unter Breaking Shadow Copies .

IVssBackupComponentsEx2::BreakSnapshotSetEx ähnelt der BreakSnapshotSet-Methode, mit der Ausnahme, dass sie über zusätzliche Parameter verfügt, um status abzufragen und anzugeben, wie der Schattenkopiensatz unterbrochen wird.

Anforderungen

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

Weitere Informationen

IVssBackupComponents

IVssBackupComponents::D eleteSnapshots