IVssBackupComponents::SetRestoreState-Methode (vsbackup.h)
Die SetRestoreState-Methode definiert eine Gesamtkonfiguration für einen Wiederherstellungsvorgang.
Syntax
HRESULT SetRestoreState(
[in] VSS_RESTORE_TYPE restoreType
);
Parameter
[in] restoreType
Ein VSS_RESTORE_TYPE Enumerationswert, der den Typ der durchzuführenden Wiederherstellung angibt.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Der Sicherungsstatus wurde erfolgreich festgelegt. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Sicherungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen. |
|
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
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
In der Regel müssen die meisten Wiederherstellungsvorgänge den Standardwiederherstellungstyp (VSS_RTYPE_UNDEFINED) nicht außer Kraft setzen. Writer sollten diesen Wiederherstellungstyp so behandeln, als wäre er VSS_RTYPE_BY_COPY.
Wenn Anwendungen SetRestoreState aufrufen müssen, sollte es vor dem Aufruf von IVssBackupComponents::P reRestore aufgerufen werden.
Wenn SetRestoreState nicht vor IVssBackupComponents::P reRestore aufgerufen wird, wird der Standardwiederherstellungszustand () verwendet.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [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 |