Partager via


Méthode CVssWriter ::OnPreRestore (vswriter.h)

La méthode OnPreRestore est appelée par un writer à la suite d’un événement PreRestore . Cette méthode est utilisée pour mettre l’enregistreur dans un état afin de prendre en charge la restauration (pour instance, mettre les services de base de données hors connexion) et pour apporter des modifications dans le document composants de sauvegarde du demandeur qui restaure des fichiers (par exemple, définir la cible de restauration pour remplacer la méthode de restauration d’origine).

OnPreRestore est une méthode virtuelle. Elle est implémentée par la classe de base CVssWriter , mais peut être remplacée par des classes dérivées.

Syntaxe

bool OnPreRestore(
  [in] IVssWriterComponents *pComponent
);

Paramètres

[in] pComponent

Pointeur vers une instanciation d’un objet IVssWriterComponents contenant les composants associés à l’enregistreur actuel dans le document des composants de sauvegarde du demandeur.

Valeur retournée

Comme implémenté par la classe de base, OnPreRestore retourne toujours true.

Toute autre implémentation de cette méthode doit retourner true , sauf en cas d’erreur irrécupérable. Si une erreur irrécupérable se produit, la méthode doit appeler la méthode CVssWriter ::SetWriterFailure pour fournir une description de l’échec avant de retourner false. Si une erreur non irrécupérable se produit, la méthode doit toujours appeler SetWriterFailure , mais retourner true. Si l’erreur est due à un problème temporaire, la méthode doit spécifier VSS_E_WRITERERROR_RETRYABLE dans l’appel à SetWriterFailure.

Dans tous les cas où une défaillance se produit, la méthode doit écrire un événement dans le journal des événements pour signaler la raison exacte de l’échec.

Remarques

L’événement PreRestore se produit avant la restauration des données sauvegardées. Il s’agit d’une occasion pour l’auteur de déterminer ce qui est restauré.

L’implémentation par défaut de cette méthode par la classe de base CVssWriter retourne true sans effectuer d’autre opération.

Cette méthode permet au writer de déterminer ce qui est restauré, de récupérer les métadonnées privées stockées dans le document de composants de sauvegarde stocké et de mettre à jour ces données.

Les enregistreurs ne doivent jamais lever d’exception de cette méthode ou de toute autre méthode de rappel CVssWriter(Ex) ::OnXxx .

Si cette méthode appelle la méthode CVssWriterEx2 ::GetSessionId, CVssWriter ::SetWriterFailure ou CVssWriterEx2 ::SetWriterFailureEx , elle doit le faire dans le même thread qui a appelé cette méthode. Pour plus d’informations, consultez Gestion des événements writer.

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)
Bibliothèque VssApi.lib

Voir aussi

CVssWriter

CVssWriter ::OnPostSnapshot

CVssWriter ::OnPrepareBackup

CVssWriter ::SetWriterFailure

IVssWriterComponents