Méthode CVssWriterEx2 ::SetWriterFailureEx (vswriter.h)

Article
03/03/2024

Définit des informations d’erreur étendues pour indiquer que l’enregistreur a rencontré un problème lors de la participation à une opération VSS.

Syntaxe

HRESULT SetWriterFailureEx(
  [in] HRESULT hrWriter,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage
);

Paramètres

[in] hrWriter

Code d’erreur à retourner au demandeur.

Voici les codes d’erreur que cette méthode peut définir.

Valeur	Signification
S_OK	L’auteur a réussi.
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT	Le cliché instantané contient uniquement un sous-ensemble des volumes nécessaires à l’enregistreur pour sauvegarder correctement le composant d’application.
VSS_E_WRITERERROR_OUTOFRESOURCES	L’enregistreur est à court de mémoire ou d’autres ressources système. La méthode recommandée pour gérer ce code d’erreur consiste à attendre dix minutes, puis à répéter l’opération, jusqu’à trois fois.
VSS_E_WRITERERROR_TIMEOUT	L’opération writer a échoué en raison d’un délai d’attente entre les événements Freeze et Thaw. La méthode recommandée pour gérer ce code d’erreur consiste à attendre dix minutes, puis à répéter l’opération, jusqu’à trois fois.
VSS_E_WRITERERROR_RETRYABLE	L’enregistreur a échoué en raison d’une erreur qui ne se produirait probablement pas si l’ensemble du processus de sauvegarde, de restauration ou de création de cliché instantané était redémarré. La méthode recommandée pour gérer ce code d’erreur consiste à attendre dix minutes, puis à répéter l’opération, jusqu’à trois fois.
VSS_E_WRITERERROR_NONRETRYABLE	L’opération writer a échoué en raison d’une erreur qui peut se reproduire si un autre cliché instantané est créé. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.
VSS_E_WRITERERROR_PARTIAL_FAILURE	L’enregistreur signale une ou plusieurs erreurs au niveau du composant. Pour signaler les erreurs, l’enregistreur doit utiliser la méthode IVssComponentEx2 ::SetFailure .

[in] hrApplication

Code d’erreur supplémentaire à retourner au demandeur. Ce paramètre est facultatif.

[in] wszApplicationMessage

Chaîne contenant un message d’erreur que le demandeur doit afficher à l’utilisateur final. L’enregistreur est chargé de localiser cette chaîne si nécessaire avant de l’utiliser dans cette méthode. Ce paramètre est facultatif et peut être NULL ou une chaîne vide.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode ne peut pas être appelée à partir de CVssWriter ::OnIdentify ou CVssWriterEx ::OnIdentifyEx.

Pour signaler les erreurs au niveau du composant, les rédacteurs doivent utiliser la méthode IVssComponentEx2 ::SetFailure .

Si le gestionnaire d’événements d’un writer (tel que CVssWriter ::OnFreeze) appelle cette méthode, il doit le faire dans le même thread que celui qui a appelé le gestionnaire d’événements. Pour plus d’informations, consultez Gestion des événements writer.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vswriter.h (inclure Vss.h, VsWriter.h)
Bibliothèque	VssApi.lib

Voir aussi

CVssWriter ::SetWriterFailure

CVssWriterEx2

IVssBackupComponentsEx3 ::GetWriterStatusEx

Share via