énumération VSS_SNAPSHOT_CONTEXT (vss.h)

Article
03/13/2024

L’énumération _VSS_SNAPSHOT_CONTEXT permet à un demandeur utilisant IVssBackupComponents ::SetContext de spécifier la façon dont un cliché instantané doit être créé, interrogé ou supprimé et le degré d’implication de l’auteur.

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 un cliché instantané non persistant à libération automatique dans lequel les enregistreurs sont impliqué dans la création.
`VSS_CTX_FILE_SHARE_BACKUP` Spécifie un cliché instantané non persistant et à libération automatique créé sans intervention de l’enregistreur.
`VSS_CTX_NAS_ROLLBACK` Spécifie un cliché instantané persistant et non à libération automatique sans intervention de l’enregistreur. Ce contexte doit être utilisé lorsqu’il n’est pas nécessaire d’impliquer le rédacteur pour s’assurer que les fichiers sont dans un état cohérent à l’époque du cliché instantané. Mécanismes de restauration de fichiers automatisés légers ou clichés instantanés persistants de partages de fichiers ou de volumes de données qui ne sont pas censés contenir des fichiers liés au système ou des bases de données peuvent s’exécuter dans ce contexte. For par exemple, un demandeur peut utiliser ce contexte pour créer un cliché instantané d’un volume NAS hébergeant des documents et partages utilisateur simples. Ces types de données n’ont pas besoin de l’intervention de l’enregistreur pour créer un cliché instantané cohérent.
`VSS_CTX_APP_ROLLBACK` Spécifie un cliché instantané persistant et non à libération automatique avec intervention de l’enregistreur. Ce contexte est conçu à utiliser lorsque des enregistreurs sont nécessaires pour s’assurer que les fichiers sont dans un état bien défini avant le cliché instantané. Mécanismes de restauration de fichiers automatisés des volumes système et des clichés instantanés à utiliser dans l’exploration ou la restauration des données les opérations peuvent s’exécuter dans ce contexte. Ce contexte est similaire à VSS_CTX_BACKUP mais permet à un demandeur de contrôler davantage la persistance du cliché instantané.
`VSS_CTX_CLIENT_ACCESSIBLE` Spécifie un cliché instantané accessible au client en lecture seule qui prend en charge les clichés instantanés pour les dossiers partagés et qui est créé sans intervention de l’enregistreur. Seul le fournisseur système (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 à libération automatique sans intervention du rédacteur.
`VSS_CTX_CLIENT_ACCESSIBLE_WRITERS` Spécifie un cliché instantané accessible au client en lecture seule qui est créé avec l’implication de l’enregistreur. Seul le fournisseur système (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_APP_ROLLBACK pour les clichés instantanés persistants et non en version automatique avec intervention du rédacteur. 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 actuellement en direct sont disponibles pour les opérations d’administration, telles que le cliché instantané requêtes (voir IVssBackupComponents ::Query). VSS_CTX_ALL est un contexte valide pour toutes les interfaces VSS, à l’exception de IVssBackupComponents ::StartSnapshotSet et IVssBackupComponents ::D oSnapshotSet.

Remarques

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

Le contexte par défaut pour les 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 du cliché instantané peut être contrôlé en utilisant un or au niveau du bit pour combiner une _VSS_VOLUME_SNAPSHOT_ATTRIBUTES prise en charge avec des valeurs de _VSS_SNAPSHOT_CONTEXT valides en tant qu’argument de la méthode IVssBackupComponents ::SetContext .

Actuellement, les seules modifications prises en charge sont l’OR au niveau du bit d’une valeur _VSS_SNAPSHOT_CONTEXT avec l’VSS_VOLSNAP_ATTR_TRANSPORTABLE et la valeur VSS_VOLSNAP_ATTR_DIFFERENTIAL ou 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 Entreprise, Windows Server 2008 Datacenter, Windows Server 2003, Êdition Entreprise ou Windows Server 2003, Datacenter Edition.

Configuration requise

Condition requise	Valeur
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

Partager via