Share via

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

  • Artikel

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