IVssSoftwareSnapshotProvider::D eleteSnapshots-Methode (vsprov.h)

Artikel
08/27/2023

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 des Zu löschenden Schattenkopiensatzes.

[in] eSourceObjectType

Typ des zu löschenden Objekts. 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, was möglich ist, um die Schattenkopien oder Schattenkopien in einem Schattenkopiesatz zu löschen. Wenn es FALSE ist, werden keine zusätzlichen Anstrengungen unternommen.

[out] plDeletedSnapshots

Zeiger auf eine Variable, die die Anzahl der gelöschten Schattenkopien empfängt.

[out] pNondeletedSnapshotID

Wenn ein Fehler auftritt, empfängt dieser Parameter einen Zeiger auf den Bezeichner der ersten Schattenkopie, die nicht gelöscht werden konnte. Andernfalls verweist er auf GUID_NULL.

Rückgabewert

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

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 über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_OBJECT_NOT_FOUND	Die angegebenen Schattenkopien wurden nicht gefunden.
VSS_E_PROVIDER_VETO	Anbieterfehler. Der Anbieter hat den Fehler im Ereignisprotokoll 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, alle verbleibenden Schattenkopien zu löschen. Die VSS_ID der nicht elezierten Schattenkopie wird in pNondeletedSnapshotID zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vsprov.h
Bibliothek	VssApi.lib

Weitere Informationen

IVssSoftwareSnapshotProvider

Freigeben über