énumération VSS_VOLUME_SNAPSHOT_ATTRIBUTES (vss.h)

Permet de spécifier des attributs supplémentaires pour un cliché instantané. Le contexte d’un cliché instantané (tel que défini par la méthode IVssBackupComponents::SetContext ) peut être modifié par un masque de bits qui contient une combinaison valide de valeurs d’énumération _VSS_VOLUME_SNAPSHOT_ATTRIBUTES et _VSS_SNAPSHOT_CONTEXT .

Syntax

typedef enum _VSS_VOLUME_SNAPSHOT_ATTRIBUTES {
  VSS_VOLSNAP_ATTR_PERSISTENT = 0x1,
  VSS_VOLSNAP_ATTR_NO_AUTORECOVERY = 0x2,
  VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE = 0x4,
  VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE = 0x8,
  VSS_VOLSNAP_ATTR_NO_WRITERS = 0x10,
  VSS_VOLSNAP_ATTR_TRANSPORTABLE = 0x20,
  VSS_VOLSNAP_ATTR_NOT_SURFACED = 0x40,
  VSS_VOLSNAP_ATTR_NOT_TRANSACTED = 0x80,
  VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED = 0x10000,
  VSS_VOLSNAP_ATTR_DIFFERENTIAL = 0x20000,
  VSS_VOLSNAP_ATTR_PLEX = 0x40000,
  VSS_VOLSNAP_ATTR_IMPORTED = 0x80000,
  VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY = 0x100000,
  VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY = 0x200000,
  VSS_VOLSNAP_ATTR_AUTORECOVER = 0x400000,
  VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY = 0x800000,
  VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT = 0x1000000,
  VSS_VOLSNAP_ATTR_TXF_RECOVERY = 0x2000000,
  VSS_VOLSNAP_ATTR_FILE_SHARE = 0x4000000
} VSS_VOLUME_SNAPSHOT_ATTRIBUTES, *PVSS_VOLUME_SNAPSHOT_ATTRIBUTES;

Constantes

 
VSS_VOLSNAP_ATTR_PERSISTENT
Valeur : 0x1
Le cliché instantané est persistant entre les redémarrages.


Cet attribut est automatiquement défini pour
_VSS_SNAPSHOT_CONTEXT contextes de
VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE,
VSS_CTX_CLIENT_ACCESSIBLE_WRITERS, et
VSS_CTX_NAS_ROLLBACK.

Cet attribut ne doit pas être utilisé explicitement par les demandeurs lors de la définition du contexte d’un cliché instantané.
VSS_VOLSNAP_ATTR_NO_AUTORECOVERY
Valeur : 0x2
La récupération automatique est désactivée pour le cliché instantané.

Un demandeur peut modifier un contexte de cliché instantané avec un OR au niveau du bit de cet attribut. Ce faisant, le demandeur demande à VSS de rendre le cliché instantané en lecture seule immédiatement après sa création, sans autoriser les rédacteurs ou d’autres applications à mettre à jour les composants dans le cliché instantané.

La désactivation de la récupération automatique peut entraîner un état incohérent du cliché instantané si l’un de ses composants est impliqué dans des opérations de base de données transactionnelles, telles que les opérations de lecture et d’écriture transactionnelles gérées par Transactional NTFS (TxF). En effet, la désactivation de la récupération automatique empêche la restauration des transactions incomplètes.

La désactivation de la récupération automatique empêche également les enregistreurs d’exclure les fichiers du cliché instantané. Lorsque la récupération automatique est désactivée, un enregistreur peut toujours appeler la méthode IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot , mais la méthode CVssWriter::OnPostSnapshot de l’enregistreur ne peut pas supprimer les fichiers du cliché instantané.

Windows Server 2003 et Windows XP : Cette valeur n’est prise en charge que sous Windows Vista.
VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE
Valeur : 0x4
Le cliché instantané spécifié est un cliché instantané accessible au client qui prend en charge les clichés instantanés pour les dossiers partagés et ne doit pas être exposé.

Cet attribut est automatiquement défini pour VSS_CTX_CLIENT_ACCESSIBLE et VSS_CTX_CLIENT_ACCESSIBLE_WRITERS.

Cet attribut ne doit pas être utilisé explicitement par les demandeurs lors de la définition du contexte d’un cliché instantané.
VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE
Valeur : 0x8
Le cliché instantané n’est pas automatiquement supprimé lorsque le processus de demande de cliché instantané se termine. Cliché instantané
ne peut être supprimé que par un appel à
IVssBackupComponents::D eleteSnapshots.


Cet attribut est automatiquement défini pour
_VSS_SNAPSHOT_CONTEXT contextes de
VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE,
VSS_CTX_CLIENT_ACCESSIBLE_WRITERS, et
VSS_CTX_NAS_ROLLBACK.

Cet attribut ne doit pas être utilisé explicitement par les demandeurs lors de la définition du contexte d’un cliché instantané.
VSS_VOLSNAP_ATTR_NO_WRITERS
Valeur : 0x10
Aucun rédacteur n’est impliqué dans la création du cliché instantané.


Cet attribut est automatiquement défini pour
_VSS_SNAPSHOT_CONTEXT contextes de
VSS_CTX_NAS_ROLLBACK, VSS_CTX_FILE_SHARE_BACKUP et
VSS_CTX_CLIENT_ACCESSIBLE.

Cet attribut ne doit pas être utilisé explicitement par les demandeurs lors de la définition du contexte d’un cliché instantané.
VSS_VOLSNAP_ATTR_TRANSPORTABLE
Valeur : 0x20
Le cliché instantané doit être transporté et ne doit donc pas être exposé localement.


Cet attribut peut être utilisé explicitement par les demandeurs lors de la définition du contexte d’un cliché instantané, si
fournisseur pour le cliché instantané prend en charge les clichés instantanés transportables.

Windows Server 2003, Standard Edition, Windows Server 2003, Web Edition et Windows XP : Cet attribut n’est pas pris en charge. Toutes les éditions de Windows Server 2003 avec SP1 prennent en charge cet attribut.

Voir Importation de transportable
Volumes
copiés instantanés pour plus d’informations.
VSS_VOLSNAP_ATTR_NOT_SURFACED
Valeur : 0x40
Le cliché instantané n’est actuellement pas exposé.


Sauf si le cliché instantané est explicitement exposé ou monté, cet attribut est défini pour tous les clichés instantanés.

Cet attribut ne doit pas être utilisé explicitement par les demandeurs lors de la définition du contexte d’un cliché instantané.
VSS_VOLSNAP_ATTR_NOT_TRANSACTED
Valeur : 0x80
Le cliché instantané n’est pas traité.

Un demandeur peut modifier un contexte de cliché instantané avec un OR au niveau du bit de cet attribut. Ce faisant, le demandeur demande à VSS de désactiver l’intégration intégrée entre VSS et les gestionnaires de transactions et de ressources.

La définition de cet attribut garantit que le demandeur ne recevra pas d’erreurs VSS_E_TRANSACTION_FREEZE_TIMEOUT. Toutefois, cela peut entraîner des conséquences indésirables, telles que la perte d’intégrité transactionnelle ou même la perte de données.

Windows Server 2003 et Windows XP : Cette valeur n’est prise en charge que sous Windows Vista.
VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED
Valeur : 0x10000
Indique qu’un fournisseur donné est un fournisseur de matériel.


Cet attribut est automatiquement défini pour les fournisseurs de matériel.

Cette valeur d’énumération ne peut pas être utilisée pour définir manuellement le contexte (à l’aide du
IVssBackupComponents::SetContext
méthode) d’un cliché instantané par un masque de bits (ou au niveau du bit OR) de cette valeur d’énumération et un cliché instantané valide
valeur de contexte à partir de
_VSS_SNAPSHOT_CONTEXT.
VSS_VOLSNAP_ATTR_DIFFERENTIAL
Valeur : 0x20000
Indique qu’un fournisseur donné utilise des données différentielles ou un mécanisme de copie sur écriture pour implémenter des clichés instantanés.


Un demandeur peut modifier un contexte de cliché instantané avec un OR au niveau du bit de cet attribut. En procédant ainsi, le
demande aux fournisseurs de créer un cliché instantané à l’aide d’une implémentation différentielle. Si aucun cliché instantané n’est fait
fournisseur installé sur le système prend en charge les attributs demandés, une VSS_E_VOLUME_NOT_SUPPORTED erreur sera
retourné à
IVssBackupComponents::AddToSnapshotSet.
VSS_VOLSNAP_ATTR_PLEX
Valeur : 0x40000
Indique qu’un fournisseur donné utilise un mécanisme de fractionnement PLEX ou en miroir pour implémenter des clichés instantanés.


Un demandeur peut modifier un contexte de cliché instantané avec un OR au niveau du bit de cet attribut. En procédant ainsi, le
demande aux fournisseurs de créer un cliché instantané à l’aide d’une implémentation PLEX. Si aucun cliché instantané n’est fait
fournisseur installé sur le système prend en charge les attributs demandés, une VSS_E_VOLUME_NOT_SUPPORTED erreur sera
retourné à
IVssBackupComponents::AddToSnapshotSet.
VSS_VOLSNAP_ATTR_IMPORTED
Valeur : 0x80000
Le cliché instantané du volume a été importé sur cet ordinateur à l’aide du
IVssBackupComponents::ImportSnapshots
plutôt qu’à l’aide de la méthode
IVssBackupComponents::D oSnapshotSet
.


Cet attribut est automatiquement défini si un cliché instantané est importé.

Cet attribut ne doit pas être utilisé explicitement par les demandeurs lors de la définition du contexte d’un cliché instantané.
VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY
Valeur : 0x100000
Le cliché instantané est exposé localement. Si cet indicateur de bits et l’indicateur de bits VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY sont
non défini, le cliché instantané est masqué.


L’attribut est automatiquement ajouté à un contexte de cliché instantané lors de l’appel du
IVssBackupComponents::ExposeSnapshot
pour exposer un cliché instantané localement.

Cet attribut ne doit pas être utilisé explicitement par les demandeurs lors de la définition du contexte d’un cliché instantané.
VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY
Valeur : 0x200000
Le cliché instantané est exposé à distance. Si cet indicateur de bits et l’indicateur de bits VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY sont
non défini, le cliché instantané est masqué.


L’attribut est automatiquement ajouté à un contexte de cliché instantané lors de l’appel du
IVssBackupComponents::ExposeSnapshot
pour exposer un cliché instantané localement.

Cet attribut ne doit pas être utilisé explicitement par les demandeurs lors de la définition du contexte d’un cliché instantané.
VSS_VOLSNAP_ATTR_AUTORECOVER
Valeur : 0x400000
Indique que l’enregistreur doit récupérer automatiquement le composant dans CVssWriter::OnPostSnapshot.

Cet attribut ne doit pas être utilisé explicitement par les demandeurs lors de la définition du contexte d’un cliché instantané.
VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY
Valeur : 0x800000
Indique que l’enregistreur doit récupérer automatiquement le composant dans CVssWriter::OnPostSnapshot si le cliché instantané est utilisé pour la restauration (pour l’exploration de données, par exemple).

Un demandeur définit cet indicateur dans le contexte de cliché instantané pour indiquer que le cliché instantané est créé à des fins autres que de sauvegarde, comme l’exploration de données.
VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT
Valeur : 0x1000000
Réservé pour le système.

Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge avant Windows Server 2008.
VSS_VOLSNAP_ATTR_TXF_RECOVERY
Valeur : 0x2000000
Indique que la récupération TxF doit être appliquée lors de la création de clichés instantanés.

Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge avant Windows Server 2008.
VSS_VOLSNAP_ATTR_FILE_SHARE
Valeur : 0x4000000

Remarques

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

Un demandeur définit le contexte d’un cliché instantané sur le point d’être créé en passant le membre de l’énumération _VSS_SNAPSHOT_CONTEXT à la méthode IVssBackupComponents::SetContext .

Les demandeurs peuvent modifier ce contexte en utilisant un or au niveau du bit de la valeur _VSS_SNAPSHOT_CONTEXT avec une valeur prise en charge de l’énumération _VSS_VOLUME_SNAPSHOT_ATTRIBUTES comme argument pour IVssBackupComponents::SetContext.

À moins qu’ils ne soient spécifiquement invités à prendre en charge un mécanisme donné, les fournisseurs sont libres d’utiliser n’importe quel type de mécanisme pour implémenter un cliché instantané. Par conséquent, dans le cas où aucune méthode de cliché instantané n’est spécifiée, le fournisseur est libre de choisir un mécanisme différentiel (VSS_VOLSNAP_ATTR_DIFFERENTIAL), un mécanisme PLEX (VSS_VOLSNAP_ATTR_PLEX) ou tout autre mécanisme pour prendre en charge le cliché instantané.

Bien qu’un fournisseur puisse prendre en charge les deux mécanismes, ils s’excluent mutuellement pour un cliché instantané donné. Les demandeurs ne doivent pas utiliser à la fois VSS_VOLSNAP_ATTR_DIFFERENTIAL et VSS_VOLSNAP_ATTR_PLEX pour modifier un contexte de cliché instantané spécifique.

Actuellement, VSS_VOLSNAP_ATTR_DIFFERENTIAL, VSS_VOLSNAP_ATTR_PLEX et VSS_VOLSNAP_ATTR_TRANSPORTABLE sont les seules valeurs de l’énumération _VSS_VOLUME_SNAPSHOT_ATTRIBUTES qui peuvent être utilisées pour modifier n’importe quel contexte.

En outre, il ne peut pas être utilisé pour modifier un contexte VSS_CTX_CLIENT_ACCESSIBLE .

Un demandeur peut obtenir des informations sur un cliché instantané spécifique (identifié par VSS_ID) en décompressant la structure VSS_SNAPSHOT_PROP de la structure VSS_OBJECT_PROP retournée par un appel à IVssBackupComponents::GetSnapshotProperties.

Un demandeur peut également obtenir une structure VSS_SNAPSHOT_PROP pour chacun des clichés instantanés en appelant IVssBackupComponents::Query et en utilisant IVssEnumObject pour itérer les retours.

Le contexte et les attributs des clichés instantanés sont trouvés sous la forme d’un masque de bits contenu dans le m_lSnapshotAttributes membre de la structure VSS_SNAPSHOT_PROP .

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 eleteSnapshots

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::ExposeSnapshot

IVssBackupComponents::GetSnapshotProperties

IVssBackupComponents::ImportSnapshots

IVssBackupComponents::SetContext

VSS_OBJECT_PROP

VSS_SNAPSHOT_PROP

_VSS_SNAPSHOT_CONTEXT