enumerazione VSS_FILE_SPEC_BACKUP_TYPE (vss.h)

Articolo
08/27/2023

L'enumerazione VSS_FILE_SPEC_BACKUP_TYPE viene usata dai writer per indicare il supporto di determinate operazioni di backup, ad esempio un backup incrementale o differenziale, sulla base di set di file (file o file specificati).

I set di file archiviati nel documento dei metadati writer vengono contrassegnati con una maschera bit (o or bit per bit) di valori VSS_FILE_SPEC_BACKUP_TYPE che indicano quanto segue:

Indica se il writer e il richiedente devono valutare un determinato set di file per la partecipazione al tipo specificato di operazioni di backup
Se il backup del file specificato richiederà una copia shadow

Sintassi

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;

Costanti


`VSS_FSBT_FULL_BACKUP_REQUIRED` Valore: 0x1 Un set di file contrassegnato con questo valore deve essere coinvolto in tutti i tipi di operazioni di backup. Un writer contrassegna un set di file con questo valore per indicare al richiedente che prevede una copia dell'oggetto corrente versione del set di file da rendere disponibile seguendo il ripristino di qualsiasi operazione di backup con un VSS_BACKUP_TYPE di VSS_BT_FULL.
`VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED` Valore: 0x2 Un writer contrassegna un set di file con questo valore per indicare al richiedente che prevede una copia dell'oggetto corrente versione del set di file da rendere disponibile seguendo il ripristino di qualsiasi operazione di backup con un VSS_BACKUP_TYPE di VSS_BT_DIFFERENTIAL. Questo valore non è supportato per i writer express.
`VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED` Valore: 0x4 Un writer contrassegna un set di file con questo valore per indicare al richiedente che prevede una copia dell'oggetto corrente versione del set di file da rendere disponibile seguendo il ripristino di qualsiasi operazione di backup con un VSS_BACKUP_TYPE di VSS_BT_INCREMENTAL. Questo valore non è supportato per i writer express.
`VSS_FSBT_LOG_BACKUP_REQUIRED` Valore: 0x8 Un writer contrassegna un set di file con questo valore per indicare al richiedente che prevede una copia dell'oggetto corrente versione del set di file da rendere disponibile seguendo il ripristino di qualsiasi operazione di backup con un VSS_BACKUP_TYPE di VSS_BT_LOG. Questo valore non è supportato per i writer express.
`VSS_FSBT_FULL_SNAPSHOT_REQUIRED` Valore: 0x100 Un set di file contrassegnato con questo valore deve essere eseguito il backup da una copia shadow di un volume (e non da volume originale) quando si partecipa a un'operazione di backup con un VSS_BACKUP_TYPE di VSS_BT_FULL.
`VSS_FSBT_DIFFERENTIAL_SNAPSHOT_REQUIRED` Valore: 0x200 Un set di file contrassegnato con questo valore deve essere eseguito il backup da una copia shadow di un volume (e non da volume originale) quando si partecipa a un'operazione di backup con un VSS_BACKUP_TYPE di VSS_BT_DIFFERENTIAL.
`VSS_FSBT_INCREMENTAL_SNAPSHOT_REQUIRED` Valore: 0x400 Un set di file contrassegnato con questo valore deve essere eseguito il backup da una copia shadow di un volume (e non da volume originale) quando si partecipa a un'operazione di backup con un VSS_BACKUP_TYPE di VSS_BT_INCREMENTAL.
`VSS_FSBT_LOG_SNAPSHOT_REQUIRED` Valore: 0x800 Un set di file contrassegnato con questo valore deve essere eseguito il backup da una copia shadow di un volume (e non da volume originale) quando si partecipa a un'operazione di backup con un VSS_BACKUP_TYPE di VSS_BT_LOG).
`VSS_FSBT_CREATED_DURING_BACKUP` Valore: 0x10000 Un writer contrassegna un set di file con questo valore per indicare al richiedente che si prevede che il file venga creato durante la sequenza di snapshot.
`VSS_FSBT_ALL_BACKUP_REQUIRED` Valore: 0xf Tipo di specifica di backup del file predefinito. Un set di file contrassegnato con questo valore deve sempre partecipare operazioni di backup e ripristino.
`VSS_FSBT_ALL_SNAPSHOT_REQUIRED` Valore: 0xf00 Requisito di copia shadow per il backup. Un set di file contrassegnato con questo valore deve sempre essere eseguito il backup da un oggetto copia shadow di un volume (e mai dal volume originale) quando partecipa a un'operazione di backup.

Commenti

Quando un writer imposta un valore necessario per il backup dell'enumerazione VSS_FILE_SPEC_BACKUP_TYPE , indica che il richiedente esegue il backup in modo che, quando il backup viene ripristinato, viene ripristinata la versione corrente del set di file. In genere, questo significa che il set di file viene copiato come parte del backup.

Questa impostazione può essere sostituita se un file viene aggiunto al documento Componenti di backup come file differenzato (usando IVssComponent::AddDifferencedFilesByLastModifyTime) o come file parziale (usando IVssComponent::AddPartialFile).

Se un file viene aggiunto come file diverso, il writer stabilisce criteri in base al quale il richiedente deve decidere se copiare o meno effettivamente un file in un supporto di backup. Un writer aggiunge in genere file diversi al documento Componenti di backup per l'inclusione in un evento PostSnapshot di backup (vedere CVssWriter::OnPostSnapshot). Per informazioni dettagliate , vedere Backup incrementali e differenziali .

Quando un writer imposta un valore di copia shadow richiesto dell'enumerazione VSS_FILE_SPEC_BACKUP_TYPE , indica che il set di file deve essere eseguito il backup da un volume copiato dall'ombreggiatura. I set di file non contrassegnati con un valore necessario per la copia shadow possono essere sottoposti a backup dal volume originale.

I writer impostano valori VSS_FILE_SPEC_BACKUP_TYPE durante la gestione di un eventoIdentifi (vedere CVssWriter::OnIdentify).

Una maschera bit (o or bit per bit) di valori VSS_FILE_SPEC_BACKUP_TYPE può essere applicata a un set di file quando viene aggiunta a un componente usando il metodo IVssCreateWriterMetadata::AddFilesToFileGroup, IVssCreateWriterMetadata::AddDatabaseFiles o IVssCreateWriterMetadata::AddDatabaseLogFiles.

Se non viene fornito alcun tipo di backup esplicito della specifica file durante l'aggiunta di una specifica di file a un componente, la specifica viene contrassegnata con il valore di VSS_FILE_SPEC_BACKUP_TYPE predefinito: (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).

I richiedenti o i writer possono recuperare il tipo di backup delle specifiche del file di un set di file usando il metodo IVssWMFiledesc::GetBackupTypeMask .