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

Article
03/06/2024

La méthode OnAbort est appelée par un writer à 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 à partir de sa tentative de participation à cette opération.

OnAbort est une méthode virtuelle pure. Elle n’est pas implémentée par la classe de base CVssWriter et doit être implémentée par des classes dérivées.

Syntaxe

bool OnAbort();

Valeur de retour

L’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

Dans cette méthode, l’enregistreur doit libérer toutes les ressources système temporaires qu’il a créées lors de la préparation de la participation à une opération VSS.

L’enregistreur ne recevra pas d’autres notifications d’événements liées à l’opération VSS à laquelle il participait après l’exécution de CVssWriter ::OnAbort .

Cette méthode ne sera pas appelée si l’enregistreur a appelé CVssWriter ::OnPostSnapshot (c’est-à-dire qu’il a reçu une notification de fin d’un cliché instantané).

Un événement Abort est généré dans les cas suivants :

Les gestionnaires d’événements Freeze et Thaw d’un writer (CVssWriter ::OnFreeze et CVssWriter ::OnThaw) retournent false ou ne peuvent pas se terminer dans la fenêtre de temps spécifiée dans CVssWriter ::Initialize.
Un demandeur génère explicitement un événement Abort en appelant IVssBackupComponents ::AbortBackup.
Il existe une défaillance du fournisseur ou de VSS lors de la création d’un cliché instantané à la suite de l’événement PrepareForSnapshot .

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