Dokumentinhalte für Sicherungskomponenten

Das Dokument für Sicherungskomponenten wird von Instanzen der IVssBackupComponents Schnittstelle verwaltet. Diese Schnittstelle enthält auch zahlreiche Methoden zum Steuern von Sicherungsvorgängen, zum Bearbeiten von Schattenkopien und zum Abfragen des Systemzustands. Nicht alle Informationen des Dokuments sind jedoch über diese Schnittstelle direkt zugänglich.

Das Dokument für Sicherungskomponenten besteht aus mehreren Datensätzen:

• Informationen dazu, welche Komponenten explizit in einen Sicherungs- oder Wiederherstellungsvorgang einbezogen wurden
• Eine Darstellung der gespeicherten Komponenten- und Writer-Informationen
• Statusinformationen zum Sicherungs-/Wiederherstellungsvorgang

Während die Komponenteninformationen sowohl für den Anforderer als auch für den Writer verfügbar sind, hat nur der Writer Zugriff auf die Statusinformationen.

Komponenteneinschlussinformationen

Das Dokument für Sicherungskomponenten enthält eine Liste dieser Komponenten, die explizit in der Sicherung und Wiederherstellung durch den Antragsteller enthalten sind. Die Liste enthält Folgendes:

• Explizit enthalten auswählbaren Komponenten.

  Die Einbeziehung dieser Dateien in Sicherungsvorgänge wird durch IVssBackupComponents::AddComponent und in Wiederherstellungsvorgängen durch IVssBackupComponents::SetSelectedForRestoreangegeben.

• Für Sicherungsuntercomponents ohne auswahlfähige Sicherungskomponente ist keine Auswahl möglich.

  Alle diese Komponenten müssen einbezogen werden, wenn komponenten des Writers in den Vorgang einbezogen werden sollen. Die Einbeziehung dieser Dateien in Sicherungsvorgänge wird durch IVssBackupComponents::AddComponent und in Wiederherstellungsvorgängen durch IVssBackupComponents::SetSelectedForRestoreangegeben.

• Komponenten, die implizit der Sicherung hinzugefügt wurden (Unterkomponenten), die für die Wiederherstellungausgewähltund der Wiederherstellung explizit hinzugefügt werden können.

  Diese Komponenten können entweder auswählbar oder nicht ausgewählt werden, verfügen jedoch über einen auswählbaren Vorgänger, der zum impliziten Auswählen dieser Komponenten für die Sicherung verwendet wurde. Sie werden dem Dokument für Sicherungskomponenten durch IVssBackupComponents::AddRestoreSubcomponenthinzugefügt.

Die Identitäten von Komponenten, die implizit in der Wiederherstellung enthalten sind, werden nicht im Dokument für Sicherungskomponenten gespeichert.

VSS hat Zugriff auf Informationen zur Komponenteneinschluss: Autoren ohne Komponenten, die explizit in einer Wiederherstellung oder Sicherung enthalten sind, erhalten keine VSS-Ereignisse nach der Generierung der PrepareForBackup oder PreRestore--Ereignisse.

Autoren können diese Informationen nicht direkt abfragen. Dies ist keine erhebliche Einschränkung, da einzelne VSS-Autoren keine detaillierten Informationen über den Status anderer Autoren auf dem System erfordern sollten und, wie oben erwähnt, diejenigen ohne eingeschlossene Komponenten nicht an der VSS-Operation teilnehmen müssen.

Ein Anforderer kann bestimmen, welche Komponenten explizit in einen Vorgang eingeschlossen wurden.

Die IVssBackupComponents::GetWriterComponentsCount Methode gibt die Anzahl der Autoren mit Komponenteninformationen zurück, die im Dokument für Sicherungskomponenten gespeichert sind (und nicht die Anzahl der Komponenten im Dokument).

Der Anforderer indiziert die gespeicherten Writer-Informationen mithilfe IVssBackupComponents::GetWriterComponents, die Instanzen der IVssWriterComponentsExt Schnittstelle zurückgibt. Die IVssWriterComponentsExt--Schnittstelle ermöglicht es dem Antragsteller, die Writer-Klasse und Writer-Instanz der teilnehmenden Autoren abzurufen sowie auf Informationen zu den Komponenten zuzugreifen, die im Dokument für Sicherungskomponenten gespeichert sind.

Informationen zu enthaltenen Komponenten

Die Darstellung der Komponentendaten des Sicherungskomponentendokuments (die keine Pfad- und Dateispezifikationsinformationen enthält), auf die über Instanzen der IVssComponent Schnittstelle zugegriffen wird.

Antragsteller und Autoren erhalten Zugriff auf Instanzen der IVssComponent Schnittstelle auf unterschiedliche Weise.

Ein Anforderer untersucht Komponentendaten auf Writer-Basis mithilfe von Instanzen der IVssWriterComponentsExt Schnittstelle, die von IVssBackupComponents::GetWriterComponentszurückgegeben wird.

Zusätzlich zu den Writer-Identifikationsinformationen stellt die IVssWriterComponentsExt Schnittstelle ein Array von Instanzen der IVssComponent Schnittstelle bereit – eine für jede der ausgewählten Autoren enthaltene Komponenten.

Wie in Backup Components Document Life Cycleerwähnt, können die Autoren zugriff auf dieselben Informationen über die IVssWriterComponents Schnittstelle beim Behandeln des PrepareForBackup-, PrepareForSnapshot-, PostSnapshot-, BackupComplete-, PreRestore- oder PostRestore-Ereignisses erhalten.

IVssComponent ermöglicht sowohl Writer- als auch Requestern das Abrufen der folgenden Informationen:

• Name, Typ und logischer Pfad einer Komponente (GetComponentName, GetComponentType, GetLogicalPath)
• Wie eine Komponente wiederhergestellt werden soll, wie durch das Wiederherstellungsziel angegeben (IVssComponent::GetRestoreTarget)
• Wenn ein alternativer Speicherort zum Wiederherstellen einer Datei verwendet wurde (GetAlternateLocationMapping, GetAlternateLocationMappingCount)
• Neue Zielinformationen, falls vorhanden (GetNewTarget, GetNewTargetCount)
• Fehlermeldungen vor und nach der Wiederherstellung (GetPreRestoreFailureMsg, GetPostRestoreFailureMsg)
• Wenn eine für die Sicherung Komponente, die einen Komponentensatz definiert, für die Wiederherstellung ausgewählt wurde (IsSelectedForRestore)
• Ob eine Sicherung oder Wiederherstellung erfolgreich war (GetBackupSucceededed, GetFileRestoreStatus)
• Alle schreibspezifischen Sicherungs- oder Wiederherstellungsoptionen, die von IVssBackupComponents::SetBackupOptions oder IVssBackupComponents::SetRestoreOptions festgelegt wurden (GetBackupOptions, GetRestoreOptions)
• Alle writer-spezifischen Metadatensicherung oder Wiederherstellungsmetadaten (GetBackupMetadata), GetRestoreMetadata)
• Zeitstempelinformationen (GetBackupStamp, GetPreviousBackupStamp)
• Informationen zu Sicherungsunterkomponenten, die explizit in einer Wiederherstellung enthalten sind (GetRestoreSubcomponent, GetRestoreSubcomponentCount)

Im Gegensatz zu Antragstellern können Autoren bestimmte Informationen im Sicherungskomponentendokument über die IVssComponent Schnittstelle ändern:

• Wie eine Komponente wiederhergestellt werden soll, wie durch das Wiederherstellungsziel angegeben (IVssComponent::SetRestoreTarget)
• Writer-spezifische Sicherungs- und Wiederherstellungsmetadaten (IVssComponent::SetBackupMetadata, IVssComponent::SetRestoreMetadata)
• Zeitstempelinformationen (SetBackupStamp)
• Fehlermeldungen vor und nach der Wiederherstellung (SetPreRestoreFailureMsg, SetPostRestoreFailureMsg)

Statusinformationen des Antragstellers

Antragsteller fügen Informationen zum Zustand eines Sicherungs- oder Wiederherstellungsvorgangs mithilfe der IVssBackupComponents Schnittstelle in das Dokument für Sicherungskomponenten ein. Writer-Anwendungen können diese Informationen über die CVssWriter Klasse abfragen.

Statusinformationen, die im Dokument für Sicherungskomponenten gespeichert sind, umfassen Folgendes:

Allgemeine Informationen zur Sicherung

• Der gesamte Sicherungstyp (inkrementell, differenzial oder vollständig)

Wird von Anforderern mithilfe von IVssBackupComponents::SetBackupState

Wird von Anforderern mithilfe von IVssBackupComponents::SetBackupState

Abgerufen von Autoren mithilfe von CVssWriter::AreComponentsSelected

Wird von Anforderern mithilfe von IVssBackupComponents::SetBackupState

Abgerufen von Autoren mithilfe von CVssWriter::IsBootableStateBackedUp

Wird von Anforderern mithilfe von IVssBackupComponents::SetBackupState

Abgerufen von Autoren mithilfe von CVssWriter::IsPartialFileSupportEnabled

Allgemeine Informationen zur Wiederherstellung

• Der allgemeine Wiederherstellungstyp (unabhängig davon, ob die Wiederherstellung durch Kopieren oder Importieren erfolgt)

Wird von Anforderern mithilfe von IVssBackupComponents::SetRestoreState

Informationen zu unterstützenden Dateien

• Der Speicherort von Bereichsdateien, die von einer bestimmten Komponente in partiellen Dateivorgängen verwendet werden

Wird von Anforderern mithilfe von IVssBackupComponents::SetRangesFilePath

Status der Informationen

• Gibt an, ob eine der Komponenten eines bestimmten Autors erfolgreich gesichert wurde.

Wird von Anforderern mithilfe von IVssBackupComponents::SetBackupSucceeded

Wird von Anforderern mithilfe von IVssBackupComponents::SetFileRestoreStatus

Abgerufen von Autoren und Anforderer mithilfe von IVssComponent::GetFileRestoreStatus

Writer-Settable Informationen

• Zusätzliche Sicherungsspezifikation für eine der Komponenten eines bestimmten Writers

Wird von Autoren mit IVssComponent::SetBackupMetadata-

Wird von Autoren mithilfe von IVssComponent::SetRestoreMetadata-

Abgerufen von Autoren und Anforderern mithilfe von IVssComponent::GetRestoreMetadata-

Wird von Autoren mit IVssComponent::SetBackupStamp

Abgerufen von Autoren und Anforderern mithilfe von IVssComponent::GetBackupStamp

Gespeichert und von Anforderern für eine bestimmte Komponente mithilfe von IVssBackupComponents::SetPreviousBackupStamp

Abgerufen von Autoren und Anforderern mithilfe von IVssComponent::GetPreviousBackupStamp

Wird von Autoren mithilfe von IVssComponent::SetPreRestoreFailureMsg oder IVssComponent::SetPostRestoreFailureMsg

Abgerufen von Autoren und Anforderern mithilfe von IVssComponent::GetPreRestoreFailureMsg oder IVssComponent::GetPostRestoreFailureMsg