énumération VSS_RESTORE_TARGET (vswriter.h)

Article
03/03/2024

L’énumération VSS_RESTORE_TARGET est utilisée par un enregistreur au moment de la restauration pour indiquer comment tous les fichiers inclus dans un composant sélectionné et tous les fichiers d’un jeu de composants qu’il définit doivent être restaurés. (Pour plus d’informations sur la sélection des composants, consultez Utilisation de la sélection et des chemins logiques .)

La définition d’une cible de restauration modifie ou remplace la méthode de restauration définie pendant la sauvegarde (voir VSS_RESTOREMETHOD_ENUM).

Syntax

typedef enum VSS_RESTORE_TARGET {
  VSS_RT_UNDEFINED = 0,
  VSS_RT_ORIGINAL,
  VSS_RT_ALTERNATE,
  VSS_RT_DIRECTED,
  VSS_RT_ORIGINAL_LOCATION
} ;

Constantes


`VSS_RT_UNDEFINED` Valeur : 0 Aucune cible n’est définie. Cette valeur indique une erreur de la part de l’enregistreur. Cette valeur n’est pas prise en charge pour les rédacteurs express.
`VSS_RT_ORIGINAL` Il s’agit de la cible de restauration par défaut. Cette valeur indique que la restauration des fichiers inclus dans un composant sélectionné (ou l’ensemble de composants) défini par ce composant) doit continuer selon la méthode de restauration d’origine spécifiée au moment de la sauvegarde par valeur VSS_RESTOREMETHOD_ENUM .
`VSS_RT_ALTERNATE` Les fichiers sont restaurés à un emplacement déterminé à partir d’un mappage d’emplacement alternatif existant. La cible de restauration doit être définie sur VSS_RT_ALTERNATE uniquement si un autre emplacement des mappages ont été définis pour tous les fichiers gérés par un composant ou un ensemble de composants sélectionnés. Cette valeur n’est pas prise en charge pour les rédacteurs express.
`VSS_RT_DIRECTED` Utilisez le ciblage dirigé par l’enregistreur au moment de la restauration pour restaurer un fichier. Le ciblage dirigé permet à un enregistreur de contrôler, fichier par fichier, la façon dont un fichier est restauré : indiquant la quantité d’un fichier à restaurer et les fichiers dans lesquels le fichier doit être restauré le fichier sauvegardé doit être restauré. Cette valeur n’est pas prise en charge pour les rédacteurs express.
`VSS_RT_ORIGINAL_LOCATION` Les fichiers sont restaurés à l’emplacement où ils se trouvaient au moment de la sauvegarde, même si l’original méthode de restauration qui a été spécifiée au moment de la sauvegarde était VSS_RME_RESTORE_TO_ALTERNATE_LOCATION. Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge. Cette valeur n’est pas prise en charge pour les rédacteurs express.

Remarques

Une cible de VSS_RT_UNDEFINED indique un état d’erreur.

Au moment de la sauvegarde, les enregistreurs définissent le comportement de restauration par défaut en indiquant une méthode de restauration (VSS_RESTOREMETHOD_ENUM) définie avec IVssCreateWriterMetadata ::SetRestoreMethod.

Si un enregistreur ne définit pas explicitement la cible de restauration d’un composant et qu’un ensemble de composants qu’il définit, par défaut, il est défini sur VSS_RT_ORIGINAL.

Au moment de la restauration, une valeur VSS_RESTORE_TARGET autre que VSS_RT_ORIGINAL remplace la valeur de la méthode de restauration spécifiée à l’origine spécifiée par VSS_RESTOREMETHOD_ENUM et définie par IVssCreateWriterMetadata ::SetRestoreMethod.

Seuls les enregistreurs (à l’aide d’IVssComponent ::SetRestoreTarget) peuvent définir une cible de restauration (VSS_RESTORE_TARGET) et modifier la façon dont les fichiers sont restaurés en remplaçant la méthode de restauration.

Les demandeurs et les rédacteurs peuvent accéder à la cible de restauration actuelle via IVssComponent ::GetRestoreTarget.

Une cible de restauration de VSS_RT_ORIGINAL ne signifie pas que les fichiers doivent être restaurés à leur emplacement d’origine, mais que la méthode de restauration spécifiée à l’origine (VSS_RESTOREMETHOD_ENUM) doit être respectée. Par instance, si un enregistreur définit une méthode de restauration d’VSS_RME_RESTORE_TO_ALTERNATE_LOCATION pour un composant sélectionné et que la cible de restauration est VSS_RT_ORIGINAL, les fichiers doivent être restaurés à l’autre emplacement défini par l’enregistreur.

(Dans cet exemple, si un enregistreur n’a pas pu définir de mappages d’emplacements de remplacement, il s’agit d’une erreur de l’enregistreur et le demandeur doit la signaler.)

Une cible de restauration de VSS_RT_ALTERNATE sans mappage d’emplacement de remplacement défini constitue une erreur d’enregistreur et le demandeur doit la signaler en tant que tel.

Pour plus d’informations, consultez Emplacements de sauvegarde et de restauration non par défaut .

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	vswriter.h

Voir aussi

IVssComponent ::GetRestoreTarget

IVssComponent ::SetRestoreTarget

VSS_RESTOREMETHOD_ENUM

Partager via