CVssWriter::OnPostRestore-Methode (vswriter.h)
Die OnPostRestore-Methode wird von einem Writer nach einem PostRestore-Ereignis aufgerufen. Es wird verwendet, um Vorgänge auszuführen, die als notwendig erachtet werden, nachdem Dateien von einem Anforderer auf dem Datenträger wiederhergestellt wurden. Diese Vorgänge können das Dokument "Sicherungskomponenten" jedoch nicht ändern.
OnPostRestore ist eine virtuelle Methode. Sie wird von der CVssWriter-Basisklasse implementiert, kann aber von abgeleiteten Klassen überschrieben werden.
Syntax
bool OnPostRestore(
[in] IVssWriterComponents *pComponent
);
Parameter
[in] pComponent
Ein Zeiger auf ein IVssWriterComponents-Objekt , das von VSS übergeben wird, um der Methode Zugriff auf die Komponenteninformationen des Writers zu gewähren. Der Wert dieses Parameters kann NULL sein, wenn der Anforderer keine Komponenten unterstützt (wenn CVssWriter::AreComponentsSelectedfalse zurückgibt).
Rückgabewert
Wie von der Basisklasse implementiert, gibt OnPostRestore immer true zurück.
Jede andere Implementierung dieser Methode muss 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
Die Standardimplementierung dieser Methode durch die CVssWriter-Basisklasse gibt true zurück, ohne einen anderen Vorgang auszuführen.
Bei Bedarf sollte ein Writer alle temporären Dateien entfernen und alle Systemressourcen freigeben, die er für seine Teilnahme an der Wiederherstellung benötigt.
Writer sollten niemals eine Ausnahme von dieser Methode oder einer anderen CVssWriter(Ex)::OnXxx-Rückrufmethode auslösen.
Mit der Generierung eines PostRestore-Ereignisses wird das Dokument der Sicherungskomponenten eines Anforderers zu einem schreibgeschützten Dokument. Daher schlagen Versuche, das Dokument über die Schnittstelle zu ändern (für instance IVssComponent::SetRestoreMetadata aufgerufen wird) in Benutzerimplementierungen von OnPostRestore fehl.
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 |