énumération VSS_FILE_SPEC_BACKUP_TYPE (vss.h)

Article
03/03/2024

L’énumération VSS_FILE_SPEC_BACKUP_TYPE est utilisée par les enregistreurs pour indiquer leur prise en charge de certaines opérations de sauvegarde, telles que la sauvegarde incrémentielle ou différentielle, sur la base de jeux de fichiers (un ou plusieurs fichiers spécifiés).

Les jeux de fichiers stockés dans le document de métadonnées writer sont marqués avec un masque de bits (ou OR au niveau du bit) de valeurs VSS_FILE_SPEC_BACKUP_TYPE indiquant les éléments suivants :

Si l’enregistreur et le demandeur doivent évaluer un jeu de fichiers donné pour la participation au type d’opérations de sauvegarde spécifié
Si la sauvegarde du fichier spécifié nécessite un cliché instantané

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;

Constantes


`VSS_FSBT_FULL_BACKUP_REQUIRED` Valeur : 0x1 Un jeu de fichiers marqué avec cette valeur doit être impliqué dans tous les types d’opérations de sauvegarde. Un writer étiquette un jeu de fichiers avec cette valeur pour indiquer au demandeur qu’il attend une copie du actuel version du jeu de fichiers pour être disponible après la restauration de toute opération de sauvegarde avec un VSS_BACKUP_TYPE de VSS_BT_FULL.
`VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED` Valeur : 0x2 Un writer étiquette un jeu de fichiers avec cette valeur pour indiquer au demandeur qu’il attend une copie du actuel version du jeu de fichiers pour être disponible après la restauration de toute opération de sauvegarde avec un VSS_BACKUP_TYPE de VSS_BT_DIFFERENTIAL. Cette valeur n’est pas prise en charge pour les rédacteurs express.
`VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED` Valeur : 0x4 Un writer étiquette un jeu de fichiers avec cette valeur pour indiquer au demandeur qu’il attend une copie du actuel version du jeu de fichiers pour être disponible après la restauration de toute opération de sauvegarde avec un VSS_BACKUP_TYPE de VSS_BT_INCREMENTAL. Cette valeur n’est pas prise en charge pour les rédacteurs express.
`VSS_FSBT_LOG_BACKUP_REQUIRED` Valeur : 0x8 Un writer étiquette un jeu de fichiers avec cette valeur pour indiquer au demandeur qu’il attend une copie du actuel version du jeu de fichiers pour être disponible après la restauration de toute opération de sauvegarde avec un VSS_BACKUP_TYPE de VSS_BT_LOG. Cette valeur n’est pas prise en charge pour les rédacteurs express.
`VSS_FSBT_FULL_SNAPSHOT_REQUIRED` Valeur : 0x100 Un jeu de fichiers marqué avec cette valeur doit être sauvegardé à partir d’un cliché instantané d’un volume (et jamais à partir du volume d’origine) lors de la participation à une opération de sauvegarde avec un VSS_BACKUP_TYPE de VSS_BT_FULL.
`VSS_FSBT_DIFFERENTIAL_SNAPSHOT_REQUIRED` Valeur : 0x200 Un jeu de fichiers marqué avec cette valeur doit être sauvegardé à partir d’un cliché instantané d’un volume (et jamais à partir du volume d’origine) lors de la participation à une opération de sauvegarde avec un VSS_BACKUP_TYPE de VSS_BT_DIFFERENTIAL.
`VSS_FSBT_INCREMENTAL_SNAPSHOT_REQUIRED` Valeur : 0x400 Un jeu de fichiers marqué avec cette valeur doit être sauvegardé à partir d’un cliché instantané d’un volume (et jamais à partir du volume d’origine) lors de la participation à une opération de sauvegarde avec un VSS_BACKUP_TYPE de VSS_BT_INCREMENTAL.
`VSS_FSBT_LOG_SNAPSHOT_REQUIRED` Valeur : 0x800 Un jeu de fichiers marqué avec cette valeur doit être sauvegardé à partir d’un cliché instantané d’un volume (et jamais à partir du volume d’origine) lors de la participation à une opération de sauvegarde avec un VSS_BACKUP_TYPE de VSS_BT_LOG).
`VSS_FSBT_CREATED_DURING_BACKUP` Valeur : 0x10000 Un writer marque un jeu de fichiers avec cette valeur pour indiquer au demandeur qu’il s’attend à ce que le fichier soit créé pendant la séquence de instantané.
`VSS_FSBT_ALL_BACKUP_REQUIRED` Valeur : 0xf Type de spécification de sauvegarde de fichier par défaut. Un jeu de fichiers marqué avec cette valeur doit toujours participer à opérations de sauvegarde et de restauration.
`VSS_FSBT_ALL_SNAPSHOT_REQUIRED` Valeur : 0xf00 Exigence de cliché instantané pour la sauvegarde. Un jeu de fichiers marqué avec cette valeur doit toujours être sauvegardé à partir d’un cliché instantané d’un volume (et jamais à partir du volume d’origine) lors de la participation à une opération de sauvegarde.

Remarques

Lorsqu’un enregistreur définit une valeur de sauvegarde requise de l’énumération VSS_FILE_SPEC_BACKUP_TYPE , cela indique que le demandeur effectue la sauvegarde de telle sorte que, lorsque la sauvegarde est restaurée, la version actuelle du jeu de fichiers est restaurée. En règle générale, cela signifie que le jeu de fichiers est copié dans le cadre de la sauvegarde.

Ce paramètre peut être remplacé si un fichier est ajouté au document composants de sauvegarde en tant que fichier différent (à l’aide de IVssComponent ::AddDifferencedFilesByLastModifyTime) ou en tant que fichier partiel (à l’aide de IVssComponent ::AddPartialFile).

Si un fichier est ajouté en tant que fichier différent, l’enregistreur établit les critères selon lesquels le demandeur doit décider s’il doit réellement copier un fichier sur un support de sauvegarde. Un enregistreur ajoute généralement des fichiers différents au document composants de sauvegarde pour les inclure dans un événement PostSnapshot de sauvegarde (voir CVssWriter ::OnPostSnapshot). Pour plus d’informations, consultez Sauvegardes incrémentielles et différentielles .

Lorsqu’un enregistreur définit une valeur de cliché instantané obligatoire de l’énumération VSS_FILE_SPEC_BACKUP_TYPE , il indique que le jeu de fichiers doit être sauvegardé à partir d’un volume copié en ombre. Les jeux de fichiers non marqués avec une valeur de cliché instantané obligatoire peuvent être sauvegardés à partir du volume d’origine.

Les enregistreurs définissent VSS_FILE_SPEC_BACKUP_TYPE valeurs lors de la gestion d’un événement Identify (consultez CVssWriter ::OnIdentify).

Un masque de bits (ou OR au niveau du bit) de valeurs VSS_FILE_SPEC_BACKUP_TYPE peut être appliqué à un jeu de fichiers lors de son ajout à un composant à l’aide de la méthode IVssCreateWriterMetadata ::AddFilesToFileGroup, IVssCreateWriterMetadata ::AddDatabaseFiles ou IVssCreateWriterMetadata ::AddDatabaseLogFiles .

Si aucun type de sauvegarde de spécification de fichier explicite n’est fourni lors de l’ajout d’une spécification de fichier à un composant, la spécification est marquée avec la valeur de VSS_FILE_SPEC_BACKUP_TYPE par défaut : (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).

Les demandeurs ou les rédacteurs peuvent récupérer le type de sauvegarde de spécification de fichier d’un jeu de fichiers à l’aide de la méthode IVssWMFiledesc ::GetBackupTypeMask .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	vss.h