Freigeben über

IVssProviderCreateSnapshotSet::AbortSnapshots-Methode (vsprov.h)

  • Artikel

Die AbortSnapshots-Methode bricht vorbereitete Schattenkopien in diesem Anbieter ab. Dies umfasst alle nicht gebundenen Schattenkopien und vorab festgelegte Schattenkopien.

Syntax

HRESULT AbortSnapshots(
  [in] VSS_ID SnapshotSetId
);

Parameter

[in] SnapshotSetId

Die VSS_ID , die den Schattenkopiersatz identifiziert.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert BESCHREIBUNG
S_OK
0x00000000L
 Der Vorgang wurde erfolgreich abgeschlossen.
E_OUTOFMEMORY
0x8007000EL
 Nicht genügend Arbeitsspeicher oder andere Systemressourcen.
E_INVALIDARG
0x80070057L
 Einer der Parameterwerte ist ungültig.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
 Der SnapshotSetId-Parameter verweist auf ein Objekt, das nicht gefunden wurde.
VSS_E_PROVIDER_VETO
0x80042306L
 Ein unerwarteter Anbieterfehler ist aufgetreten. Der Anbieter muss eine Nachricht im Anwendungsereignisprotokoll protokollieren, die dem Benutzer Informationen zur Problembehebung bereitstellt.

Hinweise

VSS ruft AbortSnapshots nur auf, nachdem der Anforderer IVssBackupComponents::D oSnapshotSet aufgerufen hat, auch wenn die Schattenkopie vor diesem Punkt fehlschlägt oder abgebrochen wird. Dies bedeutet, dass ein Anbieter erst nach dem Aufruf von EndPrepareSnapshots einen AbortSnapshots-Aufruf empfängt. Wenn eine Schattenkopie abgebrochen wird oder vor diesem Punkt fehlschlägt, erhält der Anbieter keine Angabe, bis eine neue Schattenkopie gestartet wird. Aus diesem Grund muss der Anbieter bereit sein, einen IVssHardwareSnapshotProvider::BeginPrepareSnapshot-Aufruf jederzeit zu verarbeiten. Dieser Aufruf außerhalb der Sequenz stellt den Beginn einer neuen Sequenz zur Erstellung von Schattenkopien dar und verfügt über eine neue Schattenkopiensatz-ID.

Anforderungen

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

Weitere Informationen

IVssProviderCreateSnapshotSet