Partager via


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

La méthode SetWriterFailure indique que cet enregistreur a rencontré une condition d’erreur et définit une condition d’erreur.

SetWriterFailure est une méthode protégée implémentée par la classe de base CVssWriter .

Syntaxe

HRESULT SetWriterFailure(
  [in] HRESULT hr
);

Paramètres

[in] hr

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

Valeur Signification
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT
Le cliché instantané contient uniquement un sous-ensemble des volumes nécessaires pour sauvegarder correctement un composant d’application.
VSS_E_WRITERERROR_NONRETRYABLE
L’enregistreur a échoué en raison d’une erreur qui se produirait probablement si un autre cliché instantané est créé.
VSS_E_WRITERERROR_OUTOFRESOURCES
L’enregistreur a échoué en raison d’une erreur d’allocation de ressources.
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é.
VSS_E_WRITERERROR_TIMEOUT
L’enregistreur n’a pas pu terminer la création du cliché instantané, car le délai entre les états de gel et de dégel a dépassé la valeur de délai d’attente (dwTimeoutFreeze) définie dans CVssWriter::Initialize.

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.

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

   
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

Voir aussi

CVssWriter

IVssBackupComponents::GetWriterStatus