Méthode IVssComponentEx2::SetFailure (vswriter.h)

Article
08/27/2023

Les enregistreurs VSS appellent cette méthode pour signaler les erreurs au niveau du composant.

Syntaxe

HRESULT SetFailure(
  [in] HRESULT hr,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage,
  [in] DWORD   dwReserved
);

Paramètres

[in] hr

Code d’erreur à retourner au demandeur qui appelle la méthode IVssComponentEx2::GetFailure .

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 a manqué 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 d’écriture a échoué en raison d’un délai d’attente entre les événements Freeze et Dégel. 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 d’écriture a échoué en raison d’une erreur qui peut se produire si un autre cliché instantané est créé. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.

[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.

[in] dwReserved

Ce paramètre est réservé à une utilisation ultérieure et doit être défini sur zéro.

Valeur retournée

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

Remarques

En plus d’appeler cette méthode, utilisez la méthode CVssWriterEx2::SetWriterFailureEx pour signaler qu’une défaillance partielle de l’enregistreur s’est produite.

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

Configuration requise


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

Voir aussi

IVssComponentEx2

Partager via