Classe CVssWriter (vswriter.h)
La classe CVssWriter est une classe de base abstraite qui définit l’interface par laquelle un enregistreur synchronise son état avec VSS et d’autres enregistreurs.
Chaque enregistreur doit instancier un objet dérivé de CVssWriter.
Les objets dérivés de CVssWriter doivent fournir des implémentations pour toutes les méthodes virtuelles pures de CVssWriter.
Un enregistreur peut remplacer une ou toutes les méthodes virtuelles de CVssWriter.
Pour participer à VSS, un rédacteur doit d’abord appeler CVssWriter ::Initialize , puis appeler CVssWriter ::Subscribe.
Un rédacteur met fin à sa participation en appelant CVssWriter ::Unsubscribe.
La classe de base CVssWriter est responsable du cycle de vie des interfaces passées aux gestionnaires d’événements. Notamment :
- Instance de l’interface IVssWriterComponents passée à : CVssWriter ::OnPrepareBackup
- Instance de l’interface IVssCreateWriterMetadata passée à CVssWriter ::OnIdentify.
Méthodes
La classe CVssWriter a ces méthodes.
| CVssWriter ::~CVssWriter ~CVssWriter est le destructeur de l’objet de classe CVssWriter. |
| CVssWriter ::AreComponentsSelected La méthode AreComponentsSelected indique si un demandeur s’exécute en mode de composant et prend en charge la sélection de composants individuels à sauvegarder ou sauvegarde des volumes entiers. |
| CVssWriter ::CVssWriter CVssWriter est le constructeur de l’objet de classe CVssWriter. |
| CVssWriter ::GetBackupType La méthode GetBackupType indique le type de sauvegarde à effectuer. |
| CVssWriter ::GetContext Les informations GetContext retournent le contexte actuel pour tous les clichés instantanés en cours ou possibles. |
| CVssWriter ::GetCurrentLevel La méthode GetCurrentLevel retourne le niveau d’application actuel. |
| CVssWriter ::GetCurrentSnapshotSetId La méthode GetCurrentSnapshotSetId retourne l’identificateur unique du jeu de cliché instantané. |
| CVssWriter ::GetCurrentVolumeArray La méthode GetCurrentVolumeArray retourne les noms des volumes d’origine et les chemins UNC des partages de fichiers distants d’origine qui appartiennent au jeu de cliché instantané sous la forme d’un tableau de chaînes de caractères larges terminées par null. Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP et Windows Server 2003 : les partages de fichiers distants ne sont pas pris en charge tant que Windows 8 et Windows Server 2012. |
| CVssWriter ::GetCurrentVolumeCount La méthode GetCurrentVolumeCount retourne le nombre de volumes dans le jeu de cliché instantané. |
| CVssWriter ::GetRestoreType La méthode GetRestoreType retourne le type de restauration auquel participe un enregistreur. |
| CVssWriter ::GetSnapshotDeviceName La méthode GetSnapshotDeviceName retourne le nom de l’appareil qui héberge le cliché instantané du volume ou du partage de fichiers spécifié. |
| CVssWriter ::Initialize Initialise un objet CVssWriter et permet à une application writer d’interagir avec VSS. |
| CVssWriter ::InstallAlternateWriter Non pris en charge. (CVssWriter.InstallAlternateWriter) |
| CVssWriter ::IsBootableSystemStateBackedUp La méthode IsBootableSystemStateBackedUp indique si l’état de démarrage sera sauvegardé. |
| CVssWriter ::IsPartialFileSupportEnabled La méthode IsPartialFileSupportEnabled détermine si la prise en charge partielle des fichiers est activée ou désactivée. |
| CVssWriter ::IsPathAffected La méthode IsPathAffected détermine si le répertoire ou fichier spécifié est inclus dans le jeu de cliché instantané actuel. Le chemin d’accès du répertoire ou du fichier peut être un chemin d’accès local ou un chemin UNC d’un partage de fichiers distant. |
| CVssWriter ::OnAbort La méthode OnAbort est appelée par un enregistreur à la suite d’un événement Abort émis par VSS indiquant qu’une opération de cliché instantané s’est terminée prématurément. L’enregistreur utilise cette méthode pour propre après sa tentative de participation à cette opération. |
| CVssWriter ::OnBackOffIOOnVolume Non pris en charge. (CVssWriter.OnBackOffIOOnVolume) |
| CVssWriter ::OnBackupComplete La méthode OnBackupComplete est appelée par un enregistreur à la suite d’un événement BackupComplete. Il est utilisé pour effectuer des opérations jugées nécessaires à la suite d’une sauvegarde. Toutefois, ces opérations ne peuvent pas modifier le document composants de sauvegarde. |
| CVssWriter ::OnBackupShutdown La méthode OnBackupShutdown est appelée par un rédacteur à la suite d’un événement BackupShutdown. Il est utilisé pour effectuer des opérations jugées nécessaires lorsqu’une application de sauvegarde s’arrête, en particulier en cas de plantage de l’application de sauvegarde. |
| CVssWriter ::OnContinueIOOnVolume Non pris en charge. (CVssWriter.OnContinueIOOnVolume) |
| CVssWriter ::OnFreeze La méthode OnFreeze est appelée par un enregistreur à la réception d’un événement Freeze au début d’un blocage de cliché instantané. Un enregistreur utilise cette méthode pour effectuer les opérations nécessaires pour participer au gel ou pour mettre son veto au gel. |
| CVssWriter ::OnIdentify La méthode OnIdentify est appelée par un rédacteur après la réception d’un événement Identifier. |
| CVssWriter ::OnPostRestore La méthode OnPostRestore est appelée par un enregistreur à la suite d’un événement PostRestore. Il est utilisé pour effectuer des opérations jugées nécessaires après la restauration des fichiers sur le disque par un demandeur. Toutefois, ces opérations ne peuvent pas modifier le document composants de sauvegarde. |
| CVssWriter ::OnPostSnapshot La méthode OnPostSnapshot est appelée par un enregistreur à la suite d’un événement PostSnapshot. |
| CVssWriter ::OnPrepareBackup La méthode OnPrepareBackup est appelée par un enregistreur à la suite d’un événement PrepareForBackup. Cette méthode est utilisée pour configurer l’état d’un enregistreur et ses composants en préparation d’une opération de sauvegarde. |
| CVssWriter ::OnPrepareSnapshot La méthode OnPrepareSnapshot est appelée par un enregistreur pour gérer un événement PrepareForSnapshot. Il est utilisé pour effectuer les opérations nécessaires à la préparation d’un rédacteur à participer au cliché instantané ou à mettre son veto à un cliché instantané. |
| CVssWriter ::OnPreRestore La méthode OnPreRestore est appelée par un enregistreur à la suite d’un événement PreRestore. |
| CVssWriter ::OnThaw La méthode OnThaw est appelée par un enregistreur à la suite d’un événement Degel. |
| CVssWriter ::OnVSSApplicationStartup Non pris en charge. (CVssWriter.OnVSSApplicationStartup) |
| CVssWriter ::OnVSSShutdown Non pris en charge. (CVssWriter.OnVssShutdown) |
| CVssWriter ::SetWriterFailure La méthode SetWriterFailure indique que cet enregistreur a rencontré une condition d’erreur et définit une condition d’erreur. |
| CVssWriter ::Subscribe La méthode Subscribe abonne l’enregistreur à VSS. |
| CVssWriter ::Unsubscribe La méthode Unsubscribe annule l’enregistreur avec VSS. |
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] |
| Plateforme cible | Windows |
| En-tête | vswriter.h (inclure Vss.h, VsWriter.h) |