énumération VSS_VOLUME_SNAPSHOT_ATTRIBUTES (vss.h)

Article
08/27/2023

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