énumération VSS_BACKUP_SCHEMA (vss.h)

Article
03/06/2024

L’énumération VSS_BACKUP_SCHEMA est utilisée par un enregistreur pour indiquer les types d’opérations de sauvegarde auxquels il peut participer. Les types de sauvegarde pris en charge sont exprimés en tant que masque de bits (ou OR au niveau du bit) de valeurs VSS_BACKUP_SCHEMA .

Syntax

typedef enum _VSS_BACKUP_SCHEMA {
  VSS_BS_UNDEFINED = 0,
  VSS_BS_DIFFERENTIAL = 0x1,
  VSS_BS_INCREMENTAL = 0x2,
  VSS_BS_EXCLUSIVE_INCREMENTAL_DIFFERENTIAL = 0x4,
  VSS_BS_LOG = 0x8,
  VSS_BS_COPY = 0x10,
  VSS_BS_TIMESTAMPED = 0x20,
  VSS_BS_LAST_MODIFY = 0x40,
  VSS_BS_LSN = 0x80,
  VSS_BS_WRITER_SUPPORTS_NEW_TARGET = 0x100,
  VSS_BS_WRITER_SUPPORTS_RESTORE_WITH_MOVE = 0x200,
  VSS_BS_INDEPENDENT_SYSTEM_STATE = 0x400,
  VSS_BS_ROLLFORWARD_RESTORE = 0x1000,
  VSS_BS_RESTORE_RENAME = 0x2000,
  VSS_BS_AUTHORITATIVE_RESTORE = 0x4000,
  VSS_BS_WRITER_SUPPORTS_PARALLEL_RESTORES = 0x8000
} VSS_BACKUP_SCHEMA, *PVSS_BACKUP_SCHEMA;

Constantes


`VSS_BS_UNDEFINED` Valeur : 0 L’enregistreur prend en charge une sauvegarde et une restauration complètes simples de fichiers entiers (tels que définis par un VSS_BACKUP_TYPE valeur de VSS_BT_FULL). Ce schéma de sauvegarde peut être utilisé comme base d’un incrémentiel ou sauvegarde différentielle. Il s’agit de la valeur par défaut.
`VSS_BS_DIFFERENTIAL` Valeur : 0x1 L’enregistreur prend en charge les sauvegardes différentielles (correspondant au valeur VSS_BACKUP_TYPE VSS_BT_DIFFERENTIAL). Les fichiers créés ou modifiés depuis la dernière sauvegarde complète sont enregistrés. Les fichiers ne sont pas marqués comme ayant été sauvegardés. Ce paramètre n’empêche pas le mélange de sauvegardes incrémentielles et différentielles. Cette valeur n’est pas prise en charge pour les rédacteurs express.
`VSS_BS_INCREMENTAL` Valeur : 0x2 L’enregistreur prend en charge les sauvegardes incrémentielles (correspondant à valeur VSS_BACKUP_TYPE VSS_BT_INCREMENTAL). Fichiers créés ou modifiés depuis la dernière version complète ou incrémentielle les sauvegardes sont enregistrées. Les fichiers sont marqués comme ayant été sauvegardés. Ce paramètre n’empêche pas le mélange de sauvegardes incrémentielles et différentielles. Cette valeur n’est pas prise en charge pour les rédacteurs express.
`VSS_BS_EXCLUSIVE_INCREMENTAL_DIFFERENTIAL` Valeur : 0x4 L’enregistreur prend en charge les schémas de sauvegarde différentielle et incrémentielle, mais uniquement exclusivement : par exemple, vous ne pouvez pas suivre une sauvegarde différentielle avec une sauvegarde incrémentielle. Un enregistreur ne peut pas prendre en charge ce schéma s’il le fait ne prend pas en charge les schémas incrémentiels et différentiels (VSS_BS_DIFFERENTIAL	VSS_BS_INCREMENTAL). Cette valeur n’est pas prise en charge pour les rédacteurs express.
`VSS_BS_LOG` Valeur : 0x8 L’enregistreur prend en charge les sauvegardes qui impliquent uniquement les fichiers journaux qu’il gère (correspondant à un VSS_BACKUP_TYPE valeur de VSS_BT_LOG). Ce schéma nécessite qu’un enregistreur ait ajouté au moins un fichier à at moins d’un composant à l’aide de IVssCreateWriterMetadata ::AddDataBaseLogFiles . Les demandeurs récupèrent les informations du fichier journal à l’aide de IVssWMComponent ::GetDatabaseLogFile .
`VSS_BS_COPY` Valeur : 0x10 Semblable au schéma de sauvegarde par défaut (VSS_BT_UNDEFINED), l’enregistreur prend en charge opérations de copie de sauvegarde (correspondant à VSS_BT_COPY) où les informations d’accès aux fichiers (par exemple, les informations sur le moment où un fichier a été sauvegardé pour la dernière fois) ne seront pas mises à jour non plus dans l’état de l’enregistreur. ou dans les informations du système de fichiers. Ce type de sauvegarde ne peut pas être utilisé comme base d’une sauvegarde incrémentielle ou sauvegarde différentielle.
`VSS_BS_TIMESTAMPED` Valeur : 0x20 Un enregistreur prend en charge l’utilisation du mécanisme d’horodatage VSS lors de l’évaluation si un fichier doit être inclus dans opérations différentielles ou incrémentielles (correspondant à VSS_BT_DIFFERENTIAL et VSS_BT_INCREMENTAL, respectivement) à l’aide de IVssComponent ::GetBackupStamp, IVssComponent ::GetPreviousBackupStamp, IVssComponent ::SetBackupStamp, et IVssBackupComponents ::SetPreviousBackupStamp Méthodes. Un enregistreur ne peut pas prendre en charge ce schéma s’il ne prend pas en charge les schémas de sauvegarde différentielles ou incrémentielles (VSS_BS_DIFFERENTIAL ou VSS_BS_INCREMENTAL). Cette valeur n’est pas prise en charge pour les rédacteurs express.
`VSS_BS_LAST_MODIFY` Valeur : 0x40 Lors de l’implémentation de sauvegardes incrémentielles ou différentielles avec des fichiers différents, un enregistreur peut fournir en dernier Informations sur l’heure de modification pour les fichiers (à l’aide de IVssComponent ::AddDifferencedFilesByLastModifyTime). Un demandeur peut alors utiliser IVssComponent ::GetDifferencedFile to obtenir des fichiers candidats et des informations sur leurs dernières données de modification. Le demandeur peut utiliser ce informations (ainsi que tous les enregistrements sur les opérations de sauvegarde précédentes qu’il gère) pour décider si un fichier doit être inclus dans les sauvegardes incrémentielles et différentielles. Ce schéma ne s’applique pas aux implémentations de fichiers partielles de sauvegarde incrémentielle et différentielle . Un enregistreur ne peut pas prendre en charge ce schéma s’il ne prend pas en charge les schémas de sauvegarde incrémentielle ou différentielle (VSS_BS_DIFFERENTIAL ou VSS_BS_INCREMENTAL). Cette valeur n’est pas prise en charge pour les rédacteurs express.
`VSS_BS_LSN` Valeur : 0x80 Réservé pour le système.
`VSS_BS_WRITER_SUPPORTS_NEW_TARGET` Valeur : 0x100 L’enregistreur prend en charge un demandeur qui modifie la cible pour la restauration de fichiers à l’aide de IVssBackupComponents ::AddNewTarget. (Voir Sauvegarde et restauration non par défaut Emplacements pour plus d’informations.) Cette valeur n’est pas prise en charge pour les rédacteurs express.
`VSS_BS_WRITER_SUPPORTS_RESTORE_WITH_MOVE` Valeur : 0x200 L’enregistreur prend en charge l’exécution de plusieurs instances d’enregistreur avec le même ID de classe, et il prend en charge le déplacement d’un composant vers un autre enregistreur instance au moment de la restauration à l’aide d’IVssBackupComponentsEx ::SetSelectedForRestoreEx. Cette valeur n’est pas prise en charge pour les rédacteurs express. Windows Server 2003 : Cette valeur n’est pas prise en charge tant que Windows Server 2003 avec SP1.
`VSS_BS_INDEPENDENT_SYSTEM_STATE` Valeur : 0x400 L’enregistreur prend en charge la sauvegarde des données qui font partie de l’état système, mais qui peuvent également être sauvegardées indépendamment de l’état système. Windows Server 2003 : Cette valeur n’est prise en charge que sous Windows Vista.
`VSS_BS_ROLLFORWARD_RESTORE` Valeur : 0x1000 L’enregistreur prend en charge un demandeur définissant un point de restauration par progression à l’aide de IVssBackupComponentsEx2 ::SetRollForward. Cette valeur n’est pas prise en charge pour les rédacteurs express. Windows Server 2003 : Cette valeur n’est pas prise en charge tant que Windows Vista n’est pas pris en charge.
`VSS_BS_RESTORE_RENAME` Valeur : 0x2000 L’enregistreur prend en charge un demandeur définissant un nom de restauration à l’aide de IVssBackupComponentsEx2 ::SetRestoreName. Cette valeur n’est pas prise en charge pour les rédacteurs express. Windows Server 2003 : Cette valeur n’est pas prise en charge tant que Windows Vista n’est pas pris en charge.
`VSS_BS_AUTHORITATIVE_RESTORE` Valeur : 0x4000 L’enregistreur prend en charge un paramètre de restauration faisant autorité du demandeur à l’aide de IVssBackupComponentsEx2 ::SetAuthoritativeRestore. Cette valeur n’est pas prise en charge pour les rédacteurs express. Windows Server 2003 : Cette valeur n’est pas prise en charge tant que Windows Vista n’est pas pris en charge.
`VSS_BS_WRITER_SUPPORTS_PARALLEL_RESTORES` Valeur : 0x8000 L’enregistreur prend en charge plusieurs événements de restauration non synchronisés. Cette valeur n’est pas prise en charge pour les rédacteurs express. Windows Vista et Windows Server 2003 : Cette valeur n’est pas prise en charge avant Windows Server 2008.

Remarques

Writer définit ses schémas de sauvegarde avec des appels à IVssCreateWriterMetadata ::SetBackupSchema.

Les demandeurs utilisent IVssExamineWriterMetadata ::GetBackupSchema pour déterminer le schéma de sauvegarde pris en charge par un writer.

Pour qu’un type spécifique d’opération de sauvegarde soit pris en charge, l’enregistreur doit prendre en charge le schéma correspondant et le demandeur doit définir le type de sauvegarde correspondant.

Par exemple, pour impliquer un writer dans une opération de sauvegarde incrémentielle, le demandeur doit définir le type de sauvegarde sur VSS_BT_INCREMENTAL, et l’enregistreur doit avoir un schéma de sauvegarde qui inclut VSS_BS_INCREMENTAL.

Un enregistreur qui ne prend pas en charge le schéma de sauvegarde correspondant au type de sauvegarde d’un demandeur doit traiter l’opération de sauvegarde en cours d’exécution comme s’il s’agissait d’une sauvegarde (complète) par défaut. Si le type de sauvegarde souhaité n’est pas pris en charge par le schéma de sauvegarde de l’enregistreur, le demandeur peut effectuer une sauvegarde complète pour cet enregistreur ou exclure l’enregistreur de l’opération de sauvegarde. Un demandeur peut exclure un writer en sélectionnant aucun des composants de l’enregistreur (voir Utilisation de la sélectabilité et des chemins logiques), ou en désactivant le writer (voir IVssBackupComponents ::D isableWriterClasses ou IVssBackupComponents ::D isableWriterInstances).

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