CVssWriter::OnAbort-Methode (vswriter.h)
Die OnAbort-Methode wird von einem Writer nach einem von VSS ausgegebenen Abort-Ereignis aufgerufen, das angibt, dass ein Schattenkopievorgang vorzeitig beendet wurde. Der Writer verwendet diese Methode, um den Versuch, an diesem Vorgang teilzunehmen, sauber.
OnAbort ist eine reine virtuelle Methode. Sie wird nicht von der CVssWriter-Basisklasse implementiert und muss von abgeleiteten Klassen implementiert werden.
Syntax
bool OnAbort();
Rückgabewert
Die Implementierung dieser Methode sollte true zurückgeben, außer im Fall eines schwerwiegenden Fehlers. Wenn ein schwerwiegender Fehler auftritt, muss die -Methode die CVssWriter::SetWriterFailure-Methode aufrufen, um eine Beschreibung des Fehlers bereitzustellen, bevor false zurückgegeben wird. Wenn ein nicht schwerwiegender Fehler auftritt, sollte die Methode weiterhin SetWriterFailure aufrufen, aber true zurückgeben. Wenn der Fehler durch ein vorübergehendes Problem verursacht wird, sollte die Methode VSS_E_WRITERERROR_RETRYABLE im Aufruf von SetWriterFailure angeben.
In allen Fällen, wenn ein Fehler auftritt, sollte die Methode ein Ereignis in das Ereignisprotokoll schreiben, um den genauen Grund für den Fehler zu melden.
Hinweise
Bei dieser Methode sollte der Writer alle temporären Systemressourcen freigeben, die er bei der Vorbereitung auf die Teilnahme an einem VSS-Vorgang erstellt hat.
Der Writer erhält keine weiteren Ereignisbenachrichtigungen im Zusammenhang mit dem VSS-Vorgang, an dem er teilgenommen hat, nachdem CVssWriter::OnAbort ausgeführt wurde.
Diese Methode wird nicht aufgerufen, wenn der Writer CVssWriter::OnPostSnapshot aufgerufen hat (das heißt, eine Benachrichtigung über das Ende einer Schattenkopie erhalten hat).
Ein Abortereignis wird in folgenden Fällen generiert:
- Die Freeze - und Thaw-Ereignishandler eines Writers (CVssWriter::OnFreeze und CVssWriter::OnThaw) geben false zurück oder können im in CVssWriter::Initialize angegebenen Zeitfenster nicht abgeschlossen werden.
- Ein Anforderer generiert explizit ein Abort-Ereignis, indem er IVssBackupComponents::AbortBackup aufruft.
- Bei der Erstellung einer Schattenkopie nach dem PrepareForSnapshot-Ereignis tritt ein Fehler des Anbieters oder des VSS auf.
Wenn diese Methode die CVssWriterEx2::GetSessionId-, CVssWriter::SetWriterFailure- oder CVssWriterEx2::SetWriterFailureEx-Methode aufruft, muss dies im selben Thread erfolgen, der diese Methode aufgerufen hat. Weitere Informationen finden Sie unter Writer-Ereignisbehandlung.
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 | vswriter.h (einschließlich Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |