IVssComponent-Klasse (vswriter.h)
Die IVssComponent-Schnittstelle ist eine C++-Schnittstelle (nicht COM), die Methoden zum Untersuchen und Ändern von Informationen zu Komponenten enthält, die im Dokument "Sicherungskomponenten" eines Antragstellers enthalten sind.
IVssComponent-Objekte können nur für die Komponenten abgerufen werden, die während eines Sicherungsvorgangs von der IVssBackupComponents::AddComponent-Methode explizit dem Dokument sicherungskomponenten hinzugefügt wurden.
Informationen zu Komponenten, die während eines Wiederherstellungsvorgangs mithilfe von IVssBackupComponents::AddRestoreSubcomponent explizit hinzugefügt wurden, sind über die IVssComponent-Schnittstelle nicht verfügbar.
Einige Informationen, die sowohl für Komponenten als auch für implizit ausgewählte Unterkomponenten gelten, die über IVssComponent-Objekte verfügbar sind, umfassen folgendes:
- Sicherungszeitstempel
- Fehlermeldungen vor/nach der Wiederherstellung
- Wiederherstellen von Metadaten
- Ziel wiederherstellen
- Zuordnungen alternativer Speicherorte
- Partielle Dateien
- Gerichtetes Ziel
Die Schnittstelle kann entweder von einem Writer oder einem Anforderer verwendet werden, obwohl bestimmte Methoden nur für Autoren unterstützt werden. Auf diese Weise kann ein Writer Änderungen an einem Sicherungs- oder Wiederherstellungsvorgang anfordern, z. B. das Hinzufügen eines neuen Ziels, oder informationen zu Anfordereraktionen, z. B. die Verwendung eines alternativen Speicherorts.
Die folgenden Methoden geben eine IVssComponent-Schnittstelle zurück:
Vererbung
Die IVssComponent-Schnittstelle erbt von der IUnknown-Schnittstelle . IVssComponent verfügt auch über folgende Arten von Membern:
Methoden
Die IVssComponent-Klasse verfügt über diese Methoden.
| IVssComponent::AddDifferencedFilesByLastModifyLSN Wird nicht unterstützt. (IVssComponent.AddDifferencedFilesByLastModifyLSN) |
| IVssComponent::AddDifferencedFilesByLastModifyTime Wird von einem Writer verwendet, um anzugeben, dass ein Dateisatz (eine angegebene Datei oder Dateien) mit einem Zeitstempel der letzten Änderung für die Aufnahme in eine inkrementelle oder differenzielle Sicherung mit Zeitstempeln mit ganzen Dateien ausgewertet werden soll. |
| IVssComponent::AddDirectedTarget Mit der AddDirectedTarget-Methode kann ein Writer zum Zeitpunkt der Wiederherstellung angeben, dass eine Datei (die Quelldatei) neu zugeordnet werden soll, wenn sie wiederhergestellt werden soll. |
| IVssComponent::AddPartialFile Die AddPartialFile-Methode gibt an, dass nur Teile einer bestimmten Datei gesichert werden sollen und welche Teile diese sind. |
| IVssComponent::GetAdditionalRestores Die GetAdditionalRestores-Methode wird von einem Writer während inkrementeller oder differenzieller Wiederherstellungsvorgänge verwendet, um zu bestimmen, ob für eine bestimmte Komponente zusätzliche Wiederherstellungsvorgänge erforderlich sind, um sie vollständig abzurufen. |
| IVssComponent::GetAlternateLocationMapping GetAlternateLocationMapping wird verwendet, um den alternativen Speicherort eines Dateisatzes für die Dateiwiederherstellung zurückzugeben. Diese Methode kann entweder von einem Writer oder einem Anforderer aufgerufen werden. |
| IVssComponent::GetAlternateLocationMappingCount Die GetAlternateLocationMappingCount-Methode gibt die Anzahl der alternativen Standortzuordnungen zurück, die von einem Anforderer beim Wiederherstellen von Daten verwendet werden. Entweder ein Writer oder ein Anforderer kann diese Methode aufrufen. |
| IVssComponent::GetBackupMetadata Die GetBackupMetadata-Methode ruft private, writerspezifische Sicherungsmetadaten ab, die möglicherweise während eines PrepareForBackup-Ereignisses von CVssWriter::OnPrepareBackup mithilfe von IVssComponent::SetBackupMetadata festgelegt wurden. |
| IVssComponent::GetBackupOptions Die GetBackupOptions-Methode gibt die Sicherungsoptionen zurück, die für den Writer angegeben sind, der die aktuell ausgewählte Komponente oder komponente von einem Anforderer mithilfe von IVssBackupComponents::SetBackupOptions verwaltet. |
| IVssComponent::GetBackupStamp Die GetBackupStamp-Methode gibt die Sicherungsstempelzeichenfolge zurück, die von einem Writer für eine bestimmte Komponente gespeichert ist. |
| IVssComponent::GetBackupSucceed Die GetBackupSucceed-Methode gibt den status eines vollständigen Versuchs zurück, alle Dateien einer ausgewählten Komponente oder komponente als VSS_FILE_RESTORE_STATUS-Enumeration zu sichern. |
| IVssComponent::GetComponentName Die GetComponentName-Methode gibt den logischen Namen dieser Komponente zurück. |
| IVssComponent::GetComponentType Die GetComponentType-Methode gibt den Typ dieser Komponente in Bezug auf die VSS_COMPONENT_TYPE-Enumeration zurück. |
| IVssComponent::GetDifferencedFile Die GetDifferencedFile-Methode gibt Informationen zu einem Dateisatz (einer angegebenen Datei oder einer angegebenen Datei) zurück, die an einer inkrementellen oder differenziellen Sicherung oder Wiederherstellung als differenzierte Datei teilnehmen soll, d. h. sicherungen und wiederherstellen, die ihr zugeordnet sind, sollen so implementiert werden, als ob ganze Dateien auf und von Sicherungsmedien kopiert werden (im Gegensatz zur Verwendung von Teildateien). |
| IVssComponent::GetDifferencedFilesCount Gibt die Anzahl der Dateispezifikationen in dieser Komponente (und in allen Unterkomponenten des von ihr definierten Komponentensatzes) zurück, die von einem Writer gekennzeichnet sind, der eine inkrementelle Sicherung oder Wiederherstellung als differenzierte Dateien unterstützt. |
| IVssComponent::GetDirectedTarget Die GetDirectedTarget-Methode gibt informationen zurück, die von einem Writer zur Sicherungszeit an das Dokument sicherungskomponenten gespeichert wurden, um anzugeben, dass eine Datei (die Quelldatei) bei der Wiederherstellung neu zugeordnet werden soll. |
| IVssComponent::GetDirectedTargetCount Die GetDirectedTargetCount-Methode gibt die Anzahl der Zielspezifikationen zurück, die der aktuellen Komponente zugeordnet sind. Entweder ein Writer oder ein Anforderer kann diese Methode aufrufen. |
| IVssComponent::GetFileRestoreStatus Die GetFileRestoreStatus-Methode gibt den status eines abgeschlossenen Versuchs zurück, alle Dateien einer ausgewählten Komponente oder komponente als VSS_FILE_RESTORE_STATUS-Enumeration wiederherzustellen. |
| IVssComponent::GetLogicalPath Die GetLogicalPath-Methode gibt den logischen Pfad dieser Komponente zurück. |
| IVssComponent::GetNewTarget Die GetNewTarget-Methode gibt die neuen Dateiwiederherstellungsspeicherorte für die ausgewählte Komponente oder den ausgewählten Komponentensatz zurück. |
| IVssComponent::GetNewTargetCount Die GetNewTargetCount-Methode gibt die Anzahl neuer Zielwiederherstellungsorte zurück, die einer bestimmten Komponente zugeordnet sind. |
| IVssComponent::GetPartialFile Die GetPartialFile-Methode gibt Informationen zu einer partiellen Datei zurück, die dieser Komponente zugeordnet ist. |
| IVssComponent::GetPartialFileCount Die GetPartialFileCount-Methode gibt die Anzahl der Teildateien zurück, die einer Komponente zugeordnet sind. |
| IVssComponent::GetPostRestoreFailureMsg Die GetPostRestoreFailureMsg-Methode gibt die Fehlernachricht zurück, die von einem Writer beim Behandeln des PostRestore-Ereignisses generiert wurde, wenn IVssComponent::SetPostRestoreFailureMsg eins festgelegt hat. |
| IVssComponent::GetPreRestoreFailureMsg Die GetPreRestoreFailureMsg-Methode ruft die von einem Writer generierte Fehlermeldung ab, während das PreRestore-Ereignis behandelt wird, wenn IVssComponent::SetPreRestoreFailureMsg einen Wert festgelegt hat. |
| IVssComponent::GetPreviousBackupStamp Die GetPreviousBackupStamp-Methode gibt einen vorherigen Sicherungsstempel zurück, der von einem Anforderer im Dokument Sicherungskomponenten geladen wurde. Der Wert wird von einem Writer verwendet, wenn er entscheidet, ob Dateien am differenziellen oder inkrementellen Sicherungsvorgang teilnehmen sollen. |
| IVssComponent::GetRestoreMetadata Die GetRestoreMetadata-Methode ruft private, writerspezifische Wiederherstellungsmetadaten ab, die möglicherweise während eines PreRestore-Ereignisses von CVssWriter::OnPreRestore mithilfe von IVssComponent::SetRestoreMetadata festgelegt wurden. |
| IVssComponent::GetRestoreOptions Die GetRestoreOptions-Methode ruft die Wiederherstellungsoptionen ab, die für den aktuellen Writer von einem Anforderer mithilfe von IVssBackupComponents::SetRestoreOptions angegeben wurden. |
| IVssComponent::GetRestoreSubcomponent Die GetRestoreSubcomponent-Methode gibt den angegebenen Teilkomponenten zurück, der einer bestimmten Komponente zugeordnet ist. |
| IVssComponent::GetRestoreSubcomponentCount Die GetRestoreSubcomponentCount-Methode gibt die Anzahl der Teilkomponenten zurück, die einer Komponente zugeordnet sind. |
| IVssComponent::GetRestoreTarget Die GetRestoreTarget-Methode gibt das Wiederherstellungsziel (im Sinne der VSS_RESTORE_TARGET-Enumeration) für die aktuelle Komponente zurück. |
| IVssComponent::IsSelectedForRestore Die IsSelectedForRestore-Methode bestimmt, ob die aktuelle Komponente für die Wiederherstellung ausgewählt wurde. |
| IVssComponent::SetBackupMetadata Die SetBackupMetadata-Methode legt Sicherungsmetadaten mit der Komponente fest. |
| IVssComponent::SetBackupStamp Die SetBackupStamp-Methode legt eine Zeichenfolge fest, die Informationen enthält, die angeben, wann eine Sicherung durchgeführt wurde. |
| IVssComponent::SetPostRestoreFailureMsg Die SetPostRestoreFailureMsg-Methode wird verwendet, um eine Nachricht zu erstellen, die einen Fehler bei der Verarbeitung eines PostRestore-Ereignisses beschreibt. |
| IVssComponent::SetPreRestoreFailureMsg Die SetPreRestoreFailureMsg-Methode wird verwendet, um eine Meldung zu erstellen, die einen Fehler bei der Verarbeitung eines PreRestore-Ereignisses beschreibt. |
| IVssComponent::SetRestoreMetadata Die SetRestoreMetadata-Methode legt writerspezifische Metadaten für die aktuelle Komponente fest. |
| IVssComponent::SetRestoreTarget Die SetRestoreTarget-Methode legt das Wiederherstellungsziel (im Sinne der VSS_RESTORE_TARGET-Enumeration) für die aktuelle Komponente fest. |
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 | vswriter.h (einschließlich Vss.h, VsWriter.h) |