énumération VSS_SNAPSHOT_CONTEXT (vss.h)

L’énumération _VSS_SNAPSHOT_CONTEXT permet à un demandeur à l’aide d’IVssBackupComponents::SetContext de spécifier comment une copie instantané doit être créée, interrogée ou supprimée et le degré d’implication de l’enregistreur.

Syntax

typedef enum _VSS_SNAPSHOT_CONTEXT {
  VSS_CTX_BACKUP = 0,
  VSS_CTX_FILE_SHARE_BACKUP,
  VSS_CTX_NAS_ROLLBACK,
  VSS_CTX_APP_ROLLBACK,
  VSS_CTX_CLIENT_ACCESSIBLE,
  VSS_CTX_CLIENT_ACCESSIBLE_WRITERS,
  VSS_CTX_ALL = 0xffffffff
} VSS_SNAPSHOT_CONTEXT, *PVSS_SNAPSHOT_CONTEXT;

Constantes

 
VSS_CTX_BACKUP
Valeur : 0
Contexte de sauvegarde standard. Spécifie une copie d’ombre nonpersistent en version automatique dans laquelle les enregistreurs sont
impliqué dans la création.
VSS_CTX_FILE_SHARE_BACKUP
Spécifie une version automatique, nonpersistent, créée sans intervention de l’enregistreur.
VSS_CTX_NAS_ROLLBACK
Spécifie une copie instantané persistante et non automatique sans implication de l’enregistreur. Ce contexte doit être
utilisé lorsqu’il n’est pas nécessaire d’impliquer l’enregistreur pour s’assurer que les fichiers sont dans un état cohérent au moment
de la copie d’ombre.


Mécanismes de restauration de fichiers automatisés légers ou clichés instantanés persistants de partages de fichiers ou volumes de données
qui ne sont pas censés contenir de fichiers ou de bases de données liés au système peuvent s’exécuter dans ce contexte. For
Par exemple, un demandeur peut utiliser ce contexte pour créer une copie instantanée d’un volume NAS hébergeant des documents et
partages utilisateur simples. Ces types de données n’ont pas besoin d’implication de l’enregistreur pour créer une copie instantanée cohérente.
VSS_CTX_APP_ROLLBACK
Spécifie une copie instantané persistante et non automatique avec l’implication de l’enregistreur. Ce contexte est conçu
à utiliser lorsque les enregistreurs sont nécessaires pour s’assurer que les fichiers sont dans un état bien défini avant la copie d’ombre.


Mécanismes de restauration de fichiers automatisés des volumes système et des clichés instantanés à utiliser dans l’exploration de données ou la restauration
les opérations peuvent s’exécuter sous ce contexte. Ce contexte est similaire à VSS_CTX_BACKUP
mais permet un demandeur plus de contrôle sur la persistance de la copie instantané.
VSS_CTX_CLIENT_ACCESSIBLE
Spécifie une copie instantané accessible en lecture seule et accessible au client qui prend en charge les clichés instantanés pour les dossiers partagés et est créée sans implication de l’enregistreur. Seul le fournisseur système (le fournisseur par défaut disponible sur le système) peut créer ce type de cliché instantané.

La plupart des demandeurs souhaitent utiliser le contexte VSS_CTX_NAS_ROLLBACK pour les clichés instantanés persistants et non de mise en production automatique sans implication de l’enregistreur.
VSS_CTX_CLIENT_ACCESSIBLE_WRITERS
Spécifie une copie instantané accessible en lecture seule et accessible au client créée avec l’implication de l’enregistreur. Seul le fournisseur système (le fournisseur par défaut disponible sur le système) peut créer ce type de cliché instantané.

La plupart des demandeurs souhaitent utiliser le contexte de VSS_CTX_APP_ROLLBACK pour les clichés instantanés persistants et non de mise en production automatique avec l’implication de l’enregistreur.

Windows Server 2003 et Windows XP : Ce contexte n’est pas pris en charge par Windows Server 2003 et Windows XP.
VSS_CTX_ALL
Valeur : 0xffffffff
Tous les types de clichés instantanés en direct sont disponibles pour les opérations administratives, telles que la copie instantané
requêtes (voir IVssBackupComponents::Query).
VSS_CTX_ALL est un contexte valide pour toutes les interfaces VSS, sauf
IVssBackupComponents::StartSnapshotSet
et
IVssBackupComponents::D oSnapshotSet.

Remarques

Le type de données à utiliser avec des valeurs de _VSS_SNAPSHOT_CONTEXT est LONG.

Le contexte par défaut des clichés instantanés VSS est VSS_CTX_BACKUP.

Windows XP : Le seul contexte pris en charge est la valeur par défaut VSS_CTX_BACKUP. L’appel d’IVssBackupComponents::SetContext retourne E_NOTIMPL.

Pour plus d’informations sur l’utilisation des contextes de clichés instantanés VSS, consultez Détails de l’implémentation pour la création de clichés instantanés.

Le comportement des clichés instantanés peut être contrôlé davantage à l’aide d’une or au niveau du bit pour combiner une _VSS_VOLUME_SNAPSHOT_ATTRIBUTES prise en charge avec des valeurs de _VSS_SNAPSHOT_CONTEXT valides comme argument de la méthode IVssBackupComponents::SetContext .

Actuellement, les seules modifications prises en charge sont l’OR au niveau du bit d’une valeur de _VSS_SNAPSHOT_CONTEXT avec la VSS_VOLSNAP_ATTR_TRANSPORTABLE , soit la VSS_VOLSNAP_ATTR_DIFFERENTIAL , soit la valeur VSS_VOLSNAP_ATTR_PLEX de l’énumération _VSS_VOLUME_SNAPSHOT_ATTRIBUTES .

Toutefois, ces valeurs ne peuvent pas être utilisées pour modifier VSS_CTX_CLIENT_ACCESSIBLE contexte.

L’utilisation de VSS_VOLSNAP_ATTR_TRANSPORTABLE est limitée aux systèmes exécutant Windows Server 2008 Enterprise, Windows Server 2008 Datacenter, Windows Server 2003, Êdition Entreprise ou Windows Server 2003, Datacenter Edition.

Configuration requise

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

Voir aussi

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::ExposeSnapshot

IVssBackupComponents::SetContext

VSS_OBJECT_PROP

VSS_SNAPSHOT_PROP

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES