IVssBackupComponents-Klasse (vsbackup.h)

Die IVssBackupComponents-Schnittstelle wird von einem Anforderer verwendet, um Autoren nach Datei-status abzufragen und Sicherungs-/Wiederherstellungsvorgänge auszuführen.

Anwendungen erhalten eine instance der IVssBackupComponents-Schnittstelle, indem sie CreateVssBackupComponents aufrufen.

Ein IVssBackupComponents-Objekt kann nur für einen einzelnen Sicherungs-, Wiederherstellungs - oder Abfragevorgang verwendet werden.

Nachdem der Sicherungs-, Wiederherstellungs - oder Abfragevorgang entweder erfolgreich abgeschlossen oder explizit beendet wurde, muss ein Anforderer das IVssBackupComponents-Objekt freigeben, indem er IVssBackupComponents::Release aufruft. Ein IVssBackupComponents-Objekt darf nicht wiederverwendet werden. Beispielsweise können Sie keinen Sicherungs- oder Wiederherstellungsvorgang mit demselben IVssBackupComponents-Objekt ausführen, das Sie bereits für einen Abfragevorgang verwendet haben.

Vererbung

Die IVssBackupComponents-Schnittstelle erbt von der IUnknown-Schnittstelle . IVssBackupComponents verfügt auch über die folgenden Arten von Membern:

Methoden

Die IVssBackupComponents-Klasse verfügt über diese Methoden.

IVssBackupComponents::AbortBackup Die AbortBackup-Methode benachrichtigt VSS, dass ein Sicherungsvorgang beendet wurde.
IVssBackupComponents::AddAlternativeLocationMapping Die AddAlternativeLocationMapping-Methode wird von einem Anforderer verwendet, um anzugeben, dass eine alternative Speicherortzuordnung verwendet wurde, um alle Elemente eines Dateisatzes in einer bestimmten Komponente wiederherzustellen.
IVssBackupComponents::AddComponent Wird verwendet, um dem Sicherungssatz explizit hinzuzufügen.
IVssBackupComponents::AddNewTarget Die AddNewTarget-Methode wird von einem Anforderer während eines Wiederherstellungsvorgangs verwendet, um anzugeben, dass die Sicherungsanwendung die Wiederherstellung von Dateien an einem neuen Speicherort plant.
IVssBackupComponents::AddRestoreSubcomponent Gibt an, dass ein Unterkomponentenelement eines Komponentensatzes wiederhergestellt werden soll, das für die Sicherung als nicht auswählbar, aber für die Wiederherstellung als auswählbar markiert wurde.
IVssBackupComponents::AddToSnapshotSet Die AddToSnapshotSet-Methode fügt dem Schattenkopiersatz ein ursprüngliches Volume oder eine ursprüngliche Remotedateifreigabe hinzu.
IVssBackupComponents::BackupComplete Die BackupComplete-Methode bewirkt, dass VSS ein BackupComplete-Ereignis generiert, das Autoren signalisiert, dass der Sicherungsvorgang abgeschlossen wurde.
IVssBackupComponents::BreakSnapshotSet Die BreakSnapshotSet-Methode bewirkt, dass das Vorhandensein eines Schattenkopiensatzes von VSS "vergessen" wird.
IVssBackupComponents::D eleteSnapshots Die DeleteSnapshots-Methode löscht mindestens eine Schattenkopie oder einen Schattenkopiensatz.
IVssBackupComponents::D isableWriterClasses Die DisableWriterClasses-Methode verhindert, dass eine bestimmte Klasse von Writern Ereignisse empfängt.
IVssBackupComponents::D isableWriterInstances Die DisableWriterInstances-Methode deaktiviert einen angegebenen Writer instance oder Instanzen.
IVssBackupComponents::D oSnapshotSet Committ alle Schattenkopien in diesem Satz gleichzeitig.
IVssBackupComponents::EnableWriterClasses Mit der EnableWriterClasses-Methode können die angegebenen Autoren alle Ereignisse empfangen.
IVssBackupComponents::ExposeSnapshot Die ExposeSnapshot-Methode macht eine Schattenkopie als Laufwerkbuchstaben, eingebundenen Ordner oder Dateifreigabe verfügbar.
IVssBackupComponents::FreeWriterMetadata Die FreeWriterMetadata-Methode gibt Systemressourcen frei, die beim Aufruf von IVssBackupComponents::GatherWriterMetadata zugeordnet wurden.
IVssBackupComponents::FreeWriterStatus Die FreeWriterStatus-Methode gibt Systemressourcen frei, die während des Aufrufs von IVssBackupComponents::GatherWriterStatus zugeordnet wurden.
IVssBackupComponents::GatherWriterMetadata Die GatherWriterMetadata-Methode fordert jeden Writer auf, die gesammelten Metadaten zu senden. Die -Methode generiert ein Identify-Ereignis für die Kommunikation mit Autoren.
IVssBackupComponents::GatherWriterStatus Die GatherWriterStatus-Methode fordert jeden Writer auf, eine status Nachricht zu senden.
IVssBackupComponents::GetSnapshotProperties Die GetSnapshotProperties-Methode ruft die Eigenschaften der angegebenen Schattenkopie ab.
IVssBackupComponents::GetWriterComponents Die GetWriterComponents-Methode wird verwendet, um Informationen zu den Komponenten eines bestimmten Writers zurückzugeben, die im Dokument der Sicherungskomponenten eines Anforderers gespeichert wurden.
IVssBackupComponents::GetWriterComponentsCount Die GetWriterComponentsCount-Methode gibt die Anzahl der Autoren zurück, deren Komponenten dem Dokument "Sicherungskomponenten" eines Anforderers hinzugefügt wurden.
IVssBackupComponents::GetWriterMetadata Die GetWriterMetadata-Methode gibt die Metadaten für einen bestimmten Writer zurück, der auf dem System ausgeführt wird.
IVssBackupComponents::GetWriterMetadataCount Die GetWriterMetadataCount-Methode gibt die Anzahl der Autoren mit Metadaten zurück.
IVssBackupComponents::GetWriterStatus Die GetWriterStatus-Methode gibt die status des angegebenen Writers zurück.
IVssBackupComponents::GetWriterStatusCount Die GetWriterStatusCount-Methode gibt die Anzahl der Autoren mit status zurück.
IVssBackupComponents::ImportSnapshots Importiert Schattenkopien, die von einem anderen Computer übertragen werden.
IVssBackupComponents::InitializeForBackup Die InitializeForBackup-Methode initialisiert die Metadaten der Sicherungskomponenten zur Vorbereitung der Sicherung.
IVssBackupComponents::InitializeForRestore Die InitializeForRestore-Methode initialisiert die IVssBackupComponents-Schnittstelle zur Vorbereitung eines Wiederherstellungsvorgangs.
IVssBackupComponents::IsVolumeSupported Die IsVolumeSupported-Methode bestimmt, ob der angegebene Anbieter Schattenkopien auf dem angegebenen Volume oder der angegebenen Remotedateifreigabe unterstützt.
IVssBackupComponents::P ostRestore Die PostRestore-Methode führt dazu, dass VSS ein PostRestore-Ereignis generiert, das Autoren signalisiert, dass der aktuelle Wiederherstellungsvorgang abgeschlossen ist.
IVssBackupComponents::P repareForBackup Die PrepareForBackup-Methode führt dazu, dass VSS ein PrepareForBackup-Ereignis generiert, das Autoren signalisiert, sich auf einen bevorstehenden Sicherungsvorgang vorzubereiten. Dadurch wird das Dokument der Sicherungskomponenten eines Anforderers für Autoren verfügbar.
IVssBackupComponents::P reRestore Die PreRestore-Methode führt dazu, dass VSS ein PreRestore-Ereignis generiert, das Autoren signalisiert, sich auf einen bevorstehenden Wiederherstellungsvorgang vorzubereiten.
IVssBackupComponents::Query Die Abfragemethode fragt Anbieter auf dem System und/oder die abgeschlossenen Schattenkopien im System ab, die sich im aktuellen Kontext befinden. Die Methode kann nur während Sicherungsvorgängen aufgerufen werden.
IVssBackupComponents::QueryRevertStatus Gibt einen IVssAsync-Schnittstellenzeiger zurück, mit dem die status des rückgängig machen-Vorgangs bestimmt werden kann. (IVssBackupComponents.QueryRevertStatus)
IVssBackupComponents::RevertToSnapshot Stellt ein Volume auf eine vorherige Schattenkopie zurück. (IVssBackupComponents.RevertToSnapshot)
IVssBackupComponents::SaveAsXML Die SaveAsXML-Methode speichert das Dokument der Sicherungskomponenten, das die Zustandsinformationen eines Anforderers enthält, in einer angegebenen Zeichenfolge. Dieses XML-Dokument, das das Dokument sicherungskomponenten enthält, sollte immer sicher im Rahmen eines Sicherungsvorgangs gespeichert werden.
IVssBackupComponents::SetAdditionalRestores Die SetAdditionalRestores-Methode wird von einem Anforderer während inkrementeller oder differenzieller Wiederherstellungsvorgänge verwendet, um Autoren anzugeben, dass für eine bestimmte Komponente zusätzliche Wiederherstellungsvorgänge erforderlich sind, um sie vollständig abzurufen.
IVssBackupComponents::SetBackupOptions Die SetBackupOptions-Methode legt eine Zeichenfolge privater oder writerabhängiger Sicherungsparameter für eine Komponente fest.
IVssBackupComponents::SetBackupState Die SetBackupState-Methode definiert eine Gesamtkonfiguration für einen Sicherungsvorgang.
IVssBackupComponents::SetBackupSucceeded Die SetBackupSucceed-Methode gibt an, ob die Sicherung der angegebenen Komponente eines bestimmten Writer erfolgreich war.
IVssBackupComponents::SetContext Die SetContext-Methode legt den Kontext für nachfolgende Vorgänge im Zusammenhang mit Schattenkopien fest.
IVssBackupComponents::SetFileRestoreStatus Die SetFileRestoreStatus-Methode gibt an, ob einige, alle oder keine Dateien erfolgreich wiederhergestellt wurden.
IVssBackupComponents::SetPreviousBackupStamp Die SetPreviousBackupStamp-Methode legt den Sicherungsstempel eines früheren Sicherungsvorgangs fest, auf dem ein differenzieller oder inkrementeller Sicherungsvorgang basiert.
IVssBackupComponents::SetRangesFilePath Die SetRangesFilePath-Methode wird verwendet, wenn für einen partiellen Dateivorgang eine Bereichsdatei erforderlich ist und diese Datei an einem anderen Speicherort als dem ursprünglichen wiederhergestellt wurde.
IVssBackupComponents::SetRestoreOptions Die SetRestoreOptions-Methode legt eine Zeichenfolge privater oder writerabhängiger Wiederherstellungsparameter für eine Writer-Komponente fest.
IVssBackupComponents::SetRestoreState Die SetRestoreState-Methode definiert eine Gesamtkonfiguration für einen Wiederherstellungsvorgang.
IVssBackupComponents::SetSelectedForRestore Die SetSelectedForRestore-Methode gibt an, ob die angegebene auswählbare Komponente für die Wiederherstellung ausgewählt ist.
IVssBackupComponents::StartSnapshotSet Die StartSnapshotSet-Methode erstellt einen neuen, leeren Schattenkopiersatz.

Anforderungen

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)