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
S_OK
Die Schattenkopien wurden erfolgreich gelöscht.
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 nicht über Arbeitsspeicher oder andere Systemressourcen.
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.

VSS_E_OBJECT_NOT_FOUND
Die angegebene Schattenkopie ist nicht vorhanden.
VSS_E_PROVIDER_VETO
Erwarteter Anbieterfehler. Der Anbieter hat den Fehler im Ereignisprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
VSS_E_UNEXPECTED_PROVIDER_ERROR
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

Weitere Informationen

IVssBackupComponents

IVssBackupComponents::StartSnapshotSet

VSS_ID