IVssBackupComponents::D eleteSnapshots-Methode (vsbackup.h)
Die DeleteSnapshots-Methode löscht mindestens eine Schattenkopie oder einen Schattenkopiensatz.
Syntax
HRESULT DeleteSnapshots(
[in] VSS_ID SourceObjectId,
[in] VSS_OBJECT_TYPE eSourceObjectType,
[in] BOOL bForceDelete,
[out] LONG *plDeletedSnapshots,
[out] VSS_ID *pNondeletedSnapshotID
);
Parameter
[in] SourceObjectId
Bezeichner der zu löschenden Schattenkopie oder eines Zu löschenden Schattenkopiesatzes.
[in] eSourceObjectType
Typ des Objekts, für das alle Schattenkopien gelöscht werden. Der Wert dieses Parameters ist VSS_OBJECT_SNAPSHOT oder VSS_OBJECT_SNAPSHOT_SET.
[in] bForceDelete
Wenn der Wert dieses Parameters TRUE ist, tut der Anbieter alles mögliche, um die Schattenkopie oder Schattenkopien in einem Schattenkopiersatz zu löschen. Wenn es FALSE ist, werden keine zusätzlichen Anstrengungen unternommen.
[out] plDeletedSnapshots
Anzahl der gelöschten Schattenkopien.
[out] pNondeletedSnapshotID
Wenn ein Fehler auftritt, ist der Wert dieses Parameters der Bezeichner der ersten Schattenkopie, die nicht gelöscht werden konnte. Andernfalls wird sie GUID_NULL.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Die Schattenkopien wurden erfolgreich gelöscht. |
|
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. |
|
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. |
|
Die angegebene Schattenkopie ist nicht vorhanden. |
|
Erwarteter Anbieterfehler. Der Anbieter hat den Fehler im Ereignisprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
Unerwarteter Anbieterfehler. Der Fehlercode wird im Fehlerprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
Hinweise
Mehrere Schattenkopien in einem Schattenkopiensatz werden sequenziell gelöscht. Wenn während einer dieser einzelnen Löschungen ein Fehler auftritt, wird DeleteSnapshots sofort zurückgegeben. es wird kein Versuch unternommen, verbleibende Schattenkopien zu löschen. Die VSS_ID der nicht gelöschten Schattenkopie wird in pNondeletedSnapshotID zurückgegeben.
Der Anforderer ist für die Serialisierung des Vorgangs zum Löschen des Schattenkopiervorgangs verantwortlich.
Während einer Sicherung werden Schattenkopien automatisch freigegeben, sobald die IVssBackupComponents-instance freigegeben wird. In diesem Fall ist es nicht erforderlich, Schattenkopien explizit zu löschen.
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 |