Arbeiten mit Auswahlbarkeit für Wiederherstellungs- und Unterkomponenten
Die Auswahlbarkeit für die Wiederherstellung ermöglicht dem Anfordernden zu bestimmen, wann eine Komponente einzeln wiederhergestellt werden kann. Eine Komponente, die für die Sicherung eingeschlossen wurde, kann auf zwei Arten angezeigt werden:
- Möglicherweise wurde eine Komponente explizit in die Sicherung eingeschlossen. Diese Komponenten verfügen über eine entsprechende IVssComponent-Instanz im Dokument Sicherungskomponenten. Diese Komponenten sind in einer Wiederherstellung mithilfe von IVssBackupComponents::SetSelectedForRestore enthalten.
- Eine Komponente wurde möglicherweise implizit in die Sicherung eingeschlossen. Diese Komponenten verfügen nicht über eine entsprechende IVssComponent-Instanz im Dokument Sicherungskomponenten. Es wird jedoch immer eine IVssComponent-Instanz für eine Vorgängerkomponente im Dokument geben. Diese Komponenten sind in einer Wiederherstellung mithilfe von IVssBackupComponents::AddRestoreSubcomponent enthalten.
Jede Komponente, die explizit in die Sicherung eingeschlossen wurde, kann immer einzeln für die Wiederherstellung ausgewählt werden, unabhängig von ihrem Auswählbarkeitswert für die Wiederherstellung. Die Anfordernde ruft IVssBackupComponents::SetSelectedForRestoreauf und übergibt die Writer-ID, den logischen Pfad und den Namen der jeweiligen Komponente. Komponenten, die implizit in die Sicherung eingeschlossen wurden, werden wiederhergestellt, wenn ein explizit eingeschlossener Vorgänger wiederhergestellt wird. Implizit eingeschlossene Komponenten können nur dann einzeln für die Wiederherstellung ausgewählt werden, wenn sie als für die Wiederherstellung auswählbar markiert sind. Die anfordernde Seite ruft zuerst IVssBackupComponents::SetSelectedForRestore für die nächstgelegene explizit eingeschlossene Vorgängerkomponente auf und ruft dann IVssBackupComponents::AddRestoreSubcomponent für die Vorgängerkomponente auf, um die implizit eingeschlossene Komponente für die Wiederherstellung auszuwählen. Danach wird nur die implizit ausgewählte Komponente wiederhergestellt. alle anderen Komponenten im Komponentensatz werden nicht wiederhergestellt.
Im Gegensatz zur Auswahl für die Sicherung, die immer explizit festgelegt werden muss, wenn eine Komponente mit IVssCreateWriterMetadata::AddComponenthinzugefügt wird, hat die Auswählbarkeit für die Wiederherstellung den Standardwert false, der überschrieben werden kann.
Da Komponenten der obersten Ebene (Komponenten mit einem leeren logischen Pfad) nur explizit in eine Sicherung eingeschlossen werden können, hat die Auswahl der Wiederherstellung für diese Komponenten keine Bedeutung.