Partager via


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

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