VSS_FILE_SPEC_BACKUP_TYPE-Enumeration (vss.h)

Artikel
08/27/2023

Die VSS_FILE_SPEC_BACKUP_TYPE-Enumeration wird von Writern verwendet, um die Unterstützung bestimmter Sicherungsvorgänge ( z. B. inkrementelle oder differenzielle Sicherung ) auf der Grundlage von Dateisätzen (einer angegebenen Datei oder einer angegebenen Datei) anzugeben.

Dateisätze, die im Writer Metadata Document gespeichert sind, werden mit einer Bitmaske (oder bitweisen OR) aus VSS_FILE_SPEC_BACKUP_TYPE Werten gekennzeichnet, die Folgendes angibt:

Gibt an, ob der Writer und der Anforderer einen bestimmten Dateisatz für die Teilnahme an den angegebenen Sicherungsvorgängen auswerten müssen.
Ob für die Sicherung der angegebenen Datei eine Schattenkopie erforderlich ist

Syntax

typedef enum _VSS_FILE_SPEC_BACKUP_TYPE {
  VSS_FSBT_FULL_BACKUP_REQUIRED = 0x1,
  VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED = 0x2,
  VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED = 0x4,
  VSS_FSBT_LOG_BACKUP_REQUIRED = 0x8,
  VSS_FSBT_FULL_SNAPSHOT_REQUIRED = 0x100,
  VSS_FSBT_DIFFERENTIAL_SNAPSHOT_REQUIRED = 0x200,
  VSS_FSBT_INCREMENTAL_SNAPSHOT_REQUIRED = 0x400,
  VSS_FSBT_LOG_SNAPSHOT_REQUIRED = 0x800,
  VSS_FSBT_CREATED_DURING_BACKUP = 0x10000,
  VSS_FSBT_ALL_BACKUP_REQUIRED = 0xf,
  VSS_FSBT_ALL_SNAPSHOT_REQUIRED = 0xf00
} VSS_FILE_SPEC_BACKUP_TYPE, *PVSS_FILE_SPEC_BACKUP_TYPE;

Konstanten


`VSS_FSBT_FULL_BACKUP_REQUIRED` Wert: 0x1 Ein Mit diesem Wert markierter Dateisatz muss an allen Arten von Sicherungsvorgängen beteiligt sein. Ein Writer tagt einen Dateisatz mit diesem Wert, um dem Anforderer anzugeben, dass er eine Kopie der aktuellen erwartet. Version des Dateisatzes, der nach der Wiederherstellung eines sicherungsvorgangs mit einem verfügbar sein soll VSS_BACKUP_TYPE von VSS_BT_FULL.
`VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED` Wert: 0x2 Ein Writer tagt einen Dateisatz mit diesem Wert, um dem Anforderer anzugeben, dass er eine Kopie der aktuellen erwartet. Version des Dateisatzes, der nach der Wiederherstellung eines sicherungsvorgangs mit einem verfügbar sein soll VSS_BACKUP_TYPE von VSS_BT_DIFFERENTIAL. Dieser Wert wird für Express-Writer nicht unterstützt.
`VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED` Wert: 0x4 Ein Writer tagt einen Dateisatz mit diesem Wert, um dem Anforderer anzugeben, dass er eine Kopie der aktuellen erwartet. Version des Dateisatzes, der nach der Wiederherstellung eines sicherungsvorgangs mit einem verfügbar sein soll VSS_BACKUP_TYPE von VSS_BT_INCREMENTAL. Dieser Wert wird für Express-Writer nicht unterstützt.
`VSS_FSBT_LOG_BACKUP_REQUIRED` Wert: 0x8 Ein Writer tagt einen Dateisatz mit diesem Wert, um dem Anforderer anzugeben, dass er eine Kopie der aktuellen erwartet. Version des Dateisatzes, der nach der Wiederherstellung eines sicherungsvorgangs mit einem verfügbar sein soll VSS_BACKUP_TYPE von VSS_BT_LOG. Dieser Wert wird für Express-Writer nicht unterstützt.
`VSS_FSBT_FULL_SNAPSHOT_REQUIRED` Wert: 0x100 Ein Mit diesem Wert markierter Dateisatz muss aus einer Schattenkopie eines Volumes gesichert werden (und nie aus dem Originalvolume), wenn sie an einem Sicherungsvorgang mit einem VSS_BACKUP_TYPE von VSS_BT_FULL.
`VSS_FSBT_DIFFERENTIAL_SNAPSHOT_REQUIRED` Wert: 0x200 Ein Mit diesem Wert markierter Dateisatz muss aus einer Schattenkopie eines Volumes gesichert werden (und nie aus dem Originalvolume), wenn sie an einem Sicherungsvorgang mit einem VSS_BACKUP_TYPE von VSS_BT_DIFFERENTIAL.
`VSS_FSBT_INCREMENTAL_SNAPSHOT_REQUIRED` Wert: 0x400 Ein Mit diesem Wert markierter Dateisatz muss aus einer Schattenkopie eines Volumes gesichert werden (und nie aus dem Originalvolume), wenn sie an einem Sicherungsvorgang mit einem VSS_BACKUP_TYPE von VSS_BT_INCREMENTAL.
`VSS_FSBT_LOG_SNAPSHOT_REQUIRED` Wert: 0x800 Ein Mit diesem Wert markierter Dateisatz muss aus einer Schattenkopie eines Volumes gesichert werden (und nie aus dem Originalvolume), wenn sie an einem Sicherungsvorgang mit einem VSS_BACKUP_TYPE von VSS_BT_LOG).
`VSS_FSBT_CREATED_DURING_BACKUP` Wert: 0x10000 Ein Writer tagt einen Dateisatz mit diesem Wert, um dem Anforderer anzugeben, dass er erwartet, dass die Datei während der Momentaufnahme Sequenz erstellt wird.
`VSS_FSBT_ALL_BACKUP_REQUIRED` Wert: 0xf Der Standardtyp der Dateisicherungsspezifikation. Ein Mit diesem Wert markierter Dateisatz muss immer an teilnehmen. Sicherungs- und Wiederherstellungsvorgänge.
`VSS_FSBT_ALL_SNAPSHOT_REQUIRED` Wert: 0xf00 Die Schattenkopieanforderung für die Sicherung. Ein Dateisatz, der mit diesem Wert markiert ist, muss immer aus einem gesichert werden. Schattenkopie eines Volumes (und nie vom ursprünglichen Volume) bei der Teilnahme an einem Sicherungsvorgang.

Hinweise

Wenn ein Writer einen sicherungsrelevanten Wert der VSS_FILE_SPEC_BACKUP_TYPE-Enumeration festlegt, gibt dies an, dass der Anforderer die Sicherung so ausführt, dass beim Wiederherstellen der Sicherung die aktuelle Version des Dateisatzes wiederhergestellt wird. In der Regel bedeutet dies, dass der Dateisatz als Teil der Sicherung kopiert wird.

Diese Einstellung kann überschrieben werden, wenn eine Datei dem Dokument der Sicherungskomponenten als differenzierte Datei (mithilfe von IVssComponent::AddDifferencedFilesByLastModifyTime) oder als partielle Datei (mit IVssComponent::AddPartialFile) hinzugefügt wird.

Wenn eine Datei als differenzierte Datei hinzugefügt wird, legt der Writer Kriterien fest, anhand derer der Anforderer entscheiden soll, ob eine Datei tatsächlich auf ein Sicherungsmedium kopiert werden soll. Ein Writer fügt dem Dokument der Sicherungskomponenten in der Regel unterschiedliche Dateien zur Aufnahme in ein PostSnapshot-Ereignis zur Sicherung hinzu (siehe CVssWriter::OnPostSnapshot). Weitere Informationen finden Sie unter Inkrementelle und Differenzielle Sicherungen .

Wenn ein Writer einen Schattenkopien-erforderlichen Wert der VSS_FILE_SPEC_BACKUP_TYPE-Enumeration festlegt, gibt dies an, dass der Dateisatz von einem schattenkopierten Volume gesichert werden soll. Dateisätze, die nicht mit einem Wert für Schattenkopien gekennzeichnet sind, können vom ursprünglichen Volume gesichert werden.

Writer legen beim Behandeln eines Identify-Ereignisses VSS_FILE_SPEC_BACKUP_TYPE Werte fest (siehe CVssWriter::OnIdentify).

Eine Bitmaske (oder bitweise OR) von VSS_FILE_SPEC_BACKUP_TYPE Werten kann auf einen Dateisatz angewendet werden, wenn sie einer Komponente mithilfe der IVssCreateWriterMetadata::AddFilesToFileGroup-Methode, IVssCreateWriterMetadata::AddDatabaseFiles oder IVssCreateWriterMetadata::AddDatabaseLogFiles-Methode hinzugefügt wird.

Wenn beim Hinzufügen einer Dateispezifikation zu einer Komponente kein expliziter Sicherungstyp angegeben wird, wird die Spezifikation mit dem Standardwert VSS_FILE_SPEC_BACKUP_TYPE markiert: (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).

Anforderer oder Autoren können den Sicherungstyp der Dateispezifikation eines Dateisatzes mithilfe der IVssWMFiledesc::GetBackupTypeMask-Methode wiederherstellen.

Anforderungen

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