IVssBackupComponents::BreakSnapshotSet-Methode (vsbackup.h)
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 sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Der Schattenkopiersatz wurde erfolgreich unterbrochen. |
|
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
Die angegebene Schattenkopie ist nicht vorhanden. |
|
Die Schattenkopie wurde von einem Softwareanbieter erstellt und kann nicht unterbrochen werden. |
|
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. Mit dieser Methode werden diese Schattenkopien zu regulären Volumes.
Schattenkopien von Volumes, die mit BreakSnapshotSet "kaputt" 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 zusätzliche Parameter zum Abfragen status und angeben, wie der Schattenkopiensatz beschädigt ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (einschließlich VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |