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) |