CVssWriter::OnPreRestore-Methode (vswriter.h)
Die OnPreRestore-Methode wird nach einem PreRestore-Ereignis von einem Writer aufgerufen. Diese Methode wird verwendet, um den Writer in einen Zustand zu versetzen, um die Wiederherstellung zu unterstützen (für instance, Datenbankdienste offline zu schalten) und um Änderungen im Dokument der Sicherungskomponenten des Anforderers vorzunehmen, der Dateien wiederherstellen möchte (z. B. festlegen, dass das Wiederherstellungsziel die ursprüngliche Wiederherstellungsmethode überschreibt).
OnPreRestore ist eine virtuelle Methode. Sie wird von der CVssWriter-Basisklasse implementiert, kann aber von abgeleiteten Klassen überschrieben werden.
Syntax
bool OnPreRestore(
[in] IVssWriterComponents *pComponent
);
Parameter
[in] pComponent
Zeiger auf eine Instanziierung eines IVssWriterComponents-Objekts , das die Komponenten enthält, die dem aktuellen Writer im Dokument der Sicherungskomponenten des Anforderers zugeordnet sind.
Rückgabewert
Wie von der Basisklasse implementiert, gibt OnPreRestore 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
Das PreRestore-Ereignis tritt auf, bevor gesicherte Daten tatsächlich wiederhergestellt werden. Dies ist eine Gelegenheit für den Schreiber, zu bestimmen, was wiederhergestellt wird.
Die Standardimplementierung dieser Methode durch die CVssWriter-Basisklasse gibt true zurück, ohne einen anderen Vorgang auszuführen.
Mit dieser Methode kann der Writer bestimmen, was wiederhergestellt wird, gespeicherte private Metadaten im gespeicherten Dokument der Sicherungskomponenten abrufen und diese Daten aktualisieren.
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 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 |