IVssBackupComponents::P reRestore-Methode (vsbackup.h)
Die PreRestore-Methode bewirkt, dass VSS ein PreRestore-Ereignis generiert, wodurch Writern signalisiert werden, sich auf einen bevorstehenden Wiederherstellungsvorgang vorzubereiten.
Syntax
HRESULT PreRestore(
[out] IVssAsync **ppAsync
);
Parameter
[out] ppAsync
Doppelt indirekter Zeiger auf ein IVssAsync-Objekt, das status Daten für das signalierte Ereignis enthält.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Es wurde erfolgreich ein Zeiger auf eine instance der IVssAsync-Schnittstelle zurückgegeben. Die fehlercodes, die im pHrResult-Parameter zurückgegeben werden, finden Sie unter IVssAsync::QueryStatus. |
|
Der ppAsync-Parameter verweist nicht auf einen gültigen Zeiger. Das heißt, es ist NULL. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen. |
|
Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet. |
Hinweise
Der Aufrufer ist für die Freigabe des IVssAsync-Schnittstellenzeigers verantwortlich.
Besonders zu berücksichtigen sind EFI-Systeme, wenn der Anforderer den Asr-Writer (Automated System Recovery) für die Wiederherstellung ausgewählt hat. Wenn Sie die Wiederherstellung auf einem Datenträger durchführen, der die EFI-Partition enthält, und eine der folgenden Bedingungen vorhanden ist, müssen Sie den Datenträger zuerst sauber, indem Sie die IVdsAdvancedDisk::Clean-Methode aufrufen:
- Sie stellen die Wiederherstellung auf einem EFI-Systemdatenträger her, dessen Partitionierung sich seit der letzten ASR-Sicherung geändert hat.
- Die Wiederherstellung erfolgt auf einem anderen physischen Laufwerk als dem Laufwerk, von dem die Sicherung erstellt wurde.
Weitere Informationen zum ASR-Writer finden Sie unter In-Box VSS Writers.
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 | vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |