Définition des méthodes de restauration VSS

La configuration des opérations de restauration commence réellement pendant la sauvegarde des données, lorsque les rédacteurs spécifient, dans leurs documents de métadonnées de l’enregistreur, la façon dont leurs données doivent être restaurées.

Notes

L’API MoveFileEx ne peut pas être utilisée pour restaurer des fichiers du Registre.

Ces spécifications, appelées méthodes de restauration ou cibles de restauration d’origine, peuvent être modifiées pendant la restauration en définissant de nouvelles cibles de restauration ou par les demandeurs qui restaurent de nouveaux emplacements (voir Emplacements de sauvegarde et de restauration non par défaut).

En appelant IVssCreateWriterMetadata::SetRestoreMethod, un enregistreur indique la méthode de restauration à utiliser dans son document de métadonnées writer. La méthode de restauration est définie à l’échelle de l’enregistreur et appliquée à tous les fichiers de tous les composants qu’un enregistreur gère.

Un demandeur obtient (et doit respecter) ces informations en appelant IVssExamineWriterMetadata::GetRestoreMethod.

La méthode de restauration est définie par une énumération VSS_RESTOREMETHOD_ENUM , qui est transmise à IVssCreateWriterMetadata::SetRestoreMethod et renvoyée par IVssExamineWriterMetadata::GetRestoreMethod.

Le document de métadonnées de l’enregistreur prend en charge les méthodes de restauration valides suivantes (une méthode de restauration de VSS_RME_UNDEFINED indique une erreur de rédacteur). Les chiffres résument la façon dont les différentes méthodes de restauration prises en charge et définies doivent être implémentées (VSS_RME_CUSTOM n’a aucune figure associée, car par définition, elle est spécifique à l’enregistreur et doit suivre les API et la documentation de l’auteur spécifiques) :

• VSS_RME_RESTORE_IF_NOT_THERE. Restaurez les fichiers de composant sur le disque si aucun des fichiers ne se trouve déjà sur le disque. L’état du fichier cible doit être vérifié après un événement PreRestore .
• VSS_RME_RESTORE_IF_CAN_REPLACE. Restaurez des fichiers sur le disque si tous les fichiers peuvent être remplacés. L’état du fichier cible doit être vérifié après un événement PreRestore .
• VSS_RME_STOP_RESTORE_START. Un service est arrêté avant la restauration des fichiers.
• VSS_RME_RESTORE_TO_ALTERNATE_LOCATION. Restaurez des fichiers sur le disque dans un autre emplacement. Les mappages d’emplacements de remplacement sont spécifiés dans le document de métadonnées writer.
• VSS_RME_RESTORE_AT_REBOOT. Provoquer la restauration (remplacement) des fichiers lorsque l’ordinateur est redémarré.
• VSS_RME_RESTORE_AT_REBOOT_IF_CANNOT_REPLACE. Si un fichier n’a pas pu être restauré sur le disque sur un système en cours d’exécution, il est restauré (remplacé) lorsque l’ordinateur est redémarré.
• VSS_RME_CUSTOM. Aucune des méthodes prédéfinies ne fonctionnera ; l’application de sauvegarde doit utiliser des API spécialisées pour effectuer l’opération de restauration. Pour cette méthode de sauvegarde, le demandeur doit comprendre complètement l’enregistreur en question. Pour connaître les instances actuellement prises en charge, consultez Cas d’utilisation VSS spéciaux .