IVssCreateExpressWriterMetadata::SetRestoreMethod-Methode (vswriter.h)
Gibt an, wie die Daten eines ExpressWriters wiederhergestellt werden sollen.
Syntax
HRESULT SetRestoreMethod(
[in] VSS_RESTOREMETHOD_ENUM method,
[in] LPCWSTR wszService,
[in] LPCWSTR wszUserProcedure,
[in] VSS_WRITERRESTORE_ENUM writerRestore,
[in] bool bRebootRequired
);
Parameter
[in] method
Ein VSS_RESTOREMETHOD_ENUM Enumerationswert, der die Wiederherstellungsmethode angibt, die im Wiederherstellungsvorgang verwendet werden soll. Dieser Parameter ist erforderlich und kann nicht VSS_RME_UNDEFINED, VSS_RME_RESTORE_TO_ALTERNATE_LOCATION oder VSS_RME_CUSTOM werden.
[in] wszService
Ein Zeiger auf eine Breitzeichenzeichenfolge, die den Namen eines Diensts enthält, der vor einem Wiederherstellungsvorgang beendet und dann nach dem Wiederherstellungsvorgang gestartet werden muss, wenn der Wert der MethodeVSS_RME_STOP_RESTORE_START oder VSS_RME_RESTORE_STOP_START ist.
Wenn der Wert der Methode nicht VSS_RME_STOP_RESTORE_START oder VSS_RME_RESTORE_STOP_START ist, wird dieser Parameter nicht verwendet und sollte auf NULL festgelegt werden.
[in] wszUserProcedure
Für die zukünftige Verwendung reserviert. Der Wert dieses Parameters sollte immer auf NULL festgelegt werden.
[in] writerRestore
Ein VSS_WRITERRESTORE_ENUM Enumerationswert, der angibt, ob der Writer an der Wiederherstellung seiner Daten beteiligt ist. Dieser Parameter muss auf VSS_WRE_NEVER festgelegt werden.
[in] bRebootRequired
Ein boolescher Wert, der angibt, ob nach Abschluss des Wiederherstellungsvorgangs ein Neustart erforderlich ist.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
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
Ein Express Writer kann nur eine Wiederherstellungsmethode definieren. Wenn die Wiederherstellungsmethode nicht überschrieben wird, werden alle Komponenten des Express Writers mit derselben Methode wiederhergestellt.
Express Writer überschreiben die Wiederherstellungsmethode komponentenweise, indem sie ein Wiederherstellungsziel festlegen, in der Regel bei der Behandlung eines PreRestore-Ereignisses (CVssWriter::OnPreRestore).
Es ist wichtig zu beachten, dass Trotz der Tatsache, dass Wiederherstellungsmethoden pro Writer angewendet werden, Methoden auf Komponentenbasis implementiert werden. Wenn die durch den methodenparameter angegebene Methode beispielsweise VSS_RME_RESTORE_IF_CAN_REPLACE ist, werden alle Dateien in der Komponente an ihrem ursprünglichen Speicherort wiederhergestellt, wenn sie alle ersetzt werden können, ohne dass ein Fehler auftritt. Andernfalls werden sie an ihrem alternativen Speicherort wiederhergestellt, sofern angegeben.
Eine Datei kann in einer alternativen Speicherortzuordnung wiederhergestellt werden, wenn eine der folgenden Punkte zutrifft:
- Die Wiederherstellungsmethode ist VSS_RME_RESTORE_IF_NOT_THERE, und eine Version der Datei ist bereits auf dem Datenträger vorhanden.
- Die Wiederherstellungsmethode ist VSS_RME_RESTORE_IF_CAN_REPLACE, und eine Version der Datei ist auf dem Datenträger vorhanden und kann nicht ersetzt werden.
Weitere Informationen zu Wiederherstellungsmethoden finden Sie unter Festlegen von VSS-Wiederherstellungsmethoden.
Wenn die Wiederherstellungsmethode VSS_RME_STOP_RESTORE_START oder VSS_RME_RESTORE_STOP_START ist, muss der richtige Name des Diensts als wszService-Argument angegeben werden. Informationen zur Teilnahme des Writers am Beenden und Neustarten von Diensten während eines Wiederherstellungsvorgangs finden Sie unter Beenden von Diensten für die Wiederherstellung durch Anforderer.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vswriter.h (enthalten Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |