IVssBackupComponents::SetSelectedForRestore-Methode (vsbackup.h)

Artikel
08/27/2023

Die SetSelectedForRestore-Methode gibt an, ob die angegebene auswählbare Komponente für die Wiederherstellung ausgewählt ist.

Syntax

HRESULT SetSelectedForRestore(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] bool               bSelectedForRestore
);

Parameter

[in] writerId

Writer-ID.

[in] ct

Typ der Komponente. Die möglichen Werte finden Sie unter VSS_COMPONENT_TYPE .

[in] wszLogicalPath

Mit Null beendete Breitzeichenzeichenfolge, die den logischen Pfad der Komponente enthält. Weitere Informationen finden Sie unter Logische Pfade von Komponenten.

Der Wert der Zeichenfolge, die den hier verwendeten logischen Pfad enthält, sollte dem wert entsprechen, der beim Hinzufügen der Komponente verwendet wurde.

Der logische Pfad kann NULL sein.

Es gibt keine Einschränkungen für die Zeichen, die in einem logischen Pfad ohne NULL angezeigt werden können.

[in] wszComponentName

Breitzeichenzeichenfolge mit NULL-Beendigung, die den Namen der Komponente enthält.

Die Zeichenfolge darf nicht NULL sein und sollte denselben Komponentennamen wie beim Hinzufügen der Komponente zum Sicherungssatz mithilfe von IVssBackupComponents::AddComponent enthalten.

[in] bSelectedForRestore

Wenn der Wert dieses Parameters true ist, wurde die ausgewählte Komponente für die Wiederherstellung ausgewählt. Wenn der Wert false ist, wurde die ausgewählte Komponente nicht für die Wiederherstellung ausgewählt.

Rückgabewert

Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.

Wert	Bedeutung
S_OK	Es wurde erfolgreich angegeben, dass die angegebene Komponente für die Wiederherstellung ausgewählt wurde.
E_INVALIDARG	Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY	Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE	Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen.
VSS_E_OBJECT_NOT_FOUND	Die ausgewählte Komponente ist im Dokument Sicherungskomponenten nicht vorhanden, oder ein Live-instance des Writers, der dieser Komponente entspricht, wird nicht auf dem System ausgeführt.
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

SetSelectedForRestore hat nur eine Bedeutung für Wiederherstellungen, die im Komponentenmodus ausgeführt werden.

SetSelectedForRestore kann nur für Komponenten aufgerufen werden, die dem Sicherungsdokument explizit zur Sicherungszeit mithilfe von IVssBackupComponents::AddComponent hinzugefügt wurden. Das Wiederherstellen einer Komponente, die implizit als Teil eines Komponentensatzes für die Sicherung ausgewählt wurde, muss durch Aufrufen von SetSelectedForRestore für die nächstgelegene Vorgängerkomponente erfolgen, die dem Dokument hinzugefügt wurde. Wenn nur die Daten dieser Komponente wiederhergestellt werden sollen, sollte dies über IVssBackupComponents::AddRestoreSubcomponent erreicht werden. Dies kann nur erfolgen, wenn die Komponente für die Wiederherstellung ausgewählt werden kann (siehe Arbeiten mit Auswählbarkeit und logischen Pfaden).

Diese Methode muss vor IVssBackupComponents::P reRestore aufgerufen werden.

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

Weitere Informationen

IVssBackupComponents

IVssBackupComponents::P reRestore

IVssComponent::IsSelectedForRestore

VSS_COMPONENT_TYPE

Freigeben über