CVssWriter::OnThaw-Methode (vswriter.h)

Artikel
08/27/2023

Die OnThaw-Methode wird von einem Writer nach einem Thaw-Ereignis aufgerufen.

OnThaw ist eine reine virtuelle Methode. Sie wird nicht von der CVssWriter-Basisklasse implementiert und muss von abgeleiteten Klassen implementiert werden.

Syntax

bool OnThaw();

Rückgabewert

Die Implementierung dieser Methode muss true zurückgeben, außer im Falle 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, in dem ein Fehler auftritt, sollte die -Methode ein Ereignis in das Ereignisprotokoll schreiben, um den genauen Grund für den Fehler zu melden.

Hinweise

Diese Methode wird am Ende eines Einfrierens von Schattenkopien aufgerufen, wenn Writer wieder damit beginnen können, Daten auf dem Datenträger zu ändern.

OnThaw wird verwendet, um den Writer in den normalen Betrieb zurückzugeben, wobei in der Regel Aktionen rückgängig gemacht werden, die während CVssWriter::OnPrepareSnapshot und CVssWriter::OnFreeze ausgeführt werden.

Endgültige Updates durch den Writer an den Metadaten der Sicherungskomponenten und die Bereinigung (z. B. das Entfernen temporärer Dateien) sind in der Regel für CVssWriter::OnPostSnapshot reserviert.

Writer sollten niemals eine Ausnahme von dieser Methode oder einer anderen CVssWriter(Ex)::OnXxx-Rückrufmethode auslösen.

Wenn diese Methode die CVssWriterEx2::GetSessionId-, CVssWriter::SetWriterFailure- oder CVssWriterEx2::SetWriterFailureEx-Methode aufruft, muss sie dies im selben Thread tun, der diese Methode aufgerufen hat. Weitere Informationen finden Sie unter Writer-Ereignisbehandlung.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vswriter.h (enthalten Vss.h, VsWriter.h)
Bibliothek	VssApi.lib