Méthode CVssWriter ::OnPostRestore (vswriter.h)
La méthode OnPostRestore est appelée par un writer à la suite d’un événement PostRestore . Il est utilisé pour effectuer des opérations considérées comme 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.
OnPostRestore 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 OnPostRestore(
[in] IVssWriterComponents *pComponent
);
Paramètres
[in] pComponent
Pointeur vers un objet IVssWriterComponents passé par VSS pour fournir à la méthode l’accès aux informations de composant de l’enregistreur. La valeur de ce paramètre peut être NULL si le demandeur ne prend pas en charge les composants (si CVssWriter ::AreComponentsSelected retourne false).
Valeur retournée
Comme implémenté par la classe de base, OnPostRestore 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’implémentation par défaut de cette méthode par la classe de base CVssWriter retourne true sans effectuer d’autre opération.
Si nécessaire, un enregistreur doit supprimer tous les fichiers temporaires et libérer toutes les ressources système nécessaires à sa participation à la restauration.
Les enregistreurs ne doivent jamais lever d’exception de cette méthode ou de toute autre méthode de rappel CVssWriter(Ex) ::OnXxx .
Avec la génération d’un événement PostRestore , le document des composants de sauvegarde d’un demandeur devient un document en lecture seule. Par conséquent, les tentatives de modification du document via l’interface (pour instance, l’appel de IVssComponent ::SetRestoreMetadata) échoue dans les implémentations utilisateur d’OnPostRestore.
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 |