VSS_FILE_RESTORE_STATUS-Enumeration (vswriter.h)

Die VSS_FILE_RESTORE_STATUS-Enumeration definiert den Statussatz eines Dateiwiederherstellungsvorgangs, der für die Dateien ausgeführt wird, die von einer ausgewählten Komponente oder einem ausgewählten Komponentensatz verwaltet werden (Informationen zur Auswahl von Komponenten finden Sie unter Arbeiten mit Selektivität und logischen Pfaden ).

Syntax

typedef enum VSS_FILE_RESTORE_STATUS {
  VSS_RS_UNDEFINED = 0,
  VSS_RS_NONE,
  VSS_RS_ALL,
  VSS_RS_FAILED
} ;

Konstanten

VSS_RS_UNDEFINED Wert: 0 Der Wiederherstellungsstatus ist nicht definiert. Dieser Wert gibt einen Fehler an oder gibt an, dass ein Wiederherstellungsvorgang noch nicht gestartet wurde. Dieser Wert wird nicht für Komponenten unterstützt, die sich im Besitz von Express-Writern befinden.
VSS_RS_NONE Es wurden keine Dateien wiederhergestellt. Dieser Wert gibt einen Fehler bei der Wiederherstellung an, der keine wiederhergestellten Dateien auf dem Datenträger belassen hat.
VSS_RS_ALL Alle Dateien wurden wiederhergestellt. Dieser Wert gibt den Erfolg an und sollte für jede Komponente festgelegt werden. erfolgreich wiederhergestellt.
VSS_RS_FAILED Fehler beim Wiederherstellungsvorgang. Dieser Wert gibt einen Fehler bei der Wiederherstellung an, der einige wiederhergestellte Dateien auf dem Datenträger belassen hat. Dies bedeutet, dass Komponenten auf dem Datenträger sind jetzt beschädigt.

Hinweise

Wenn Dateien, die von einer Komponente verwaltet werden, oder, wenn sie einen Komponentensatz definiert, keines ihrer Unterkomponenten wiederhergestellt werden kann, muss der Wert von VSS_FILE_RESTORE_STATUS auf einen Fehler hinweisen.

Sowohl die Werte VSS_RS_FAILED als auch VSS_RS_NONE zeigen an, dass ein Wiederherstellungsvorgang nicht erfolgreich abgeschlossen wurde:

• VSS_RS_NONE weist auf einen fehlerbehafteten Wiederherstellungsfehler hin: Es wurden keine Dateien aus der Komponente oder ihren Unterkomponenten auf dem Datenträger wiederhergestellt.
• VSS_RS_FAIL weist darauf hin, dass eine Wiederherstellung ordnungsgemäß fehlgeschlagen ist, sodass einige Dateien auf dem Datenträger wiederhergestellt und einige Dateien nicht gespeichert wurden.

Die Anforderer müssen eine Wiederherstellungs-status (mithilfe von IVssBackupComponents::SetFileRestoreStatus) für jede Komponente (und deren Komponentensatz, wenn sie eine definiert) festlegen, die explizit für die Wiederherstellung im Dokument der Sicherungskomponenten hinzugefügt wird (entweder mithilfe von IVssBackupComponents::SetSelectedForRestore oder IVssBackupComponents::AddRestoreSubcomponent).

Autoren und Anforderer können die status der Wiederherstellung einer Komponente oder eines Komponentensatzes abfragen, der durch eine auswählbare Komponente definiert ist, indem IVssComponent::GetFileRestoreStatus aufgerufen wird. Wenn diese Methode für eine Komponente aufgerufen wird, die nicht ausgewählt wurde, ist der zurückgegebene Wert nicht definiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	vswriter.h

Weitere Informationen

IVssBackupComponents::SetFileRestoreStatus

IVssComponent::GetFileRestoreStatus