IVssExamineWriterMetadata::GetRestoreMethod-Methode (vsbackup.h)
Die GetRestoreMethod-Methode gibt Informationen darüber zurück, wie ein Writer seine Daten wiederherzustellen wünscht.
Syntax
HRESULT GetRestoreMethod(
[out] VSS_RESTOREMETHOD_ENUM *pMethod,
[out] BSTR *pbstrService,
[out] BSTR *pbstrUserProcedure,
[out] VSS_WRITERRESTORE_ENUM *pwriterRestore,
[out] bool *pbRebootRequired,
[out] UINT *pcMappings
);
Parameter
[out] pMethod
Zeiger auf einen VSS_RESTOREMETHOD_ENUM Wert, der das Überschreiben von Dateien angibt, die Verwendung alternativer Speicherorte, die die Methode angeben, die im Wiederherstellungsvorgang verwendet wird.
[out] pbstrService
Wenn der Wert von pMethod VSS_RME_STOP_RESTORE_START oder VSS_RME_RESTORE_STOP_START ist, zeigen Sie auf eine Zeichenfolge, die den Namen des gestarteten und beendeten Diensts enthält. Andernfalls ist der Wert NULL.
[out] pbstrUserProcedure
Zeiger auf die URL eines HTML- oder XML-Dokuments, das dem Benutzer beschreibt, wie die Wiederherstellung ausgeführt werden soll. Der Wert kann NULL sein.
[out] pwriterRestore
Zeiger auf einen VSS_WRITERRESTORE_ENUM Wert, der angibt, ob der Writer an der Wiederherstellung seiner Daten beteiligt ist.
[out] pbRebootRequired
Zeiger auf einen booleschen Wert, der angibt, ob nach Abschluss des Wiederherstellungsvorgangs ein Neustart erforderlich ist. Der Wert erhält true , wenn ein Neustart erforderlich ist, oder andernfalls false .
[out] pcMappings
Zeiger auf die Anzahl alternativer Zuordnungen, die dem Writer zugeordnet sind.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Die Informationen zur Wiederherstellungsmethode wurden erfolgreich zurückgegeben. |
|
Eine Wiederherstellungsmethode ist nicht vorhanden. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über 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
Der Aufrufer muss den von den Parametern pbstrUserProcedure und pbstrService verwendeten Arbeitsspeicher durch Aufrufen von SysFreeString freigeben.
Eine Datei sollte immer in ihrer alternativen Speicherortzuordnung wiederhergestellt werden, wenn einer der folgenden Punkte zutrifft:
- Die Wiederherstellungsmethode (zur Sicherungszeit festgelegt) wird VSS_RME_RESTORE_TO_ALTERNATE_LOCATION.
- Das Wiederherstellungsziel wurde (zur Wiederherstellungszeit) auf VSS_RT_ALTERNATE festgelegt.
Eine Datei kann in einer alternativen Speicherortzuordnung wiederhergestellt werden, wenn :
- 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.
Eine alternative Speicherortzuordnung wird nur während eines Wiederherstellungsvorgangs verwendet und sollte nicht mit einem alternativen Pfad verwechselt werden, der nur während eines Sicherungsvorgangs verwendet wird.
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, verwendet ein Anforderer den von pbstrService zurückgegebenen Namen, um zu bestimmen, welcher Dienst während der Wiederherstellung beendet und nach der Wiederherstellung neu gestartet werden muss. 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 XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (einschließlich VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |