IVssExamineWriterMetadata::GetRestoreMethod-Methode (vsbackup.h)

Artikel
08/27/2023

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
S_OK	Die Informationen zur Wiederherstellungsmethode wurden erfolgreich zurückgegeben.
S_FALSE	Eine Wiederherstellungsmethode ist nicht vorhanden.
E_INVALIDARG	Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY	Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_INVALID_XML_DOCUMENT	Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
VSS_E_UNEXPECTED	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.

In beiden Fällen stellt dies einen Schreibfehler dar, wenn keine gültige alternative Standortzuordnung definiert ist.

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.

Wenn keine gültige alternative Standortzuordnung definiert ist, stellt dies einen Schreibfehler dar.

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

Weitere Informationen

IVssCreateWriterMetadata::SetRestoreMethod

IVssExamineWriterMetadata

Freigeben über