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

Artikel
03/03/2024

Löscht bestimmte Momentaufnahmen oder alle Momentaufnahmen in einem angegebenen Momentaufnahme Satz.

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 Schattenkopie.

[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 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

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 sie auf 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_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

Der VSS-Koordinator ruft diese Methode im Rahmen des Momentaufnahme automatischen Freigabeprozesses auf. Die -Methode wird auch als Antwort auf anforderungsgesteuerte Löschvorgänge aufgerufen.

Anforderungen

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

Weitere Informationen

IVssFileShareSnapshotProvider

Freigeben über