Partager via


Méthode IVssComponentEx::SetPrepareForBackupFailureMsg (vswriter.h)

Définit une chaîne de message d’échec PrepareForBackup pour un composant.

Cette méthode ne peut être appelée que par la méthode CVssWriter::OnPrepareBackup d’un enregistreur.

Syntaxe

HRESULT SetPrepareForBackupFailureMsg(
  [in] LPCWSTR wszFailureMsg
);

Paramètres

[in] wszFailureMsg

Adresse d’une chaîne de caractères larges avec arrêt NULL allouée à l’appelant contenant le message d’échec qui décrit une erreur qui s’est produite lors du traitement d’un événement PrepareForBackup .

Valeur retournée

Voici les codes de retour valides pour cette méthode.

Valeur Signification
S_OK
Le message d’échec a été correctement défini.
E_INVALIDARG
L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY
L’appelant n’a pas de mémoire ou d’autres ressources système.
VSS_E_BAD_STATE
Cette méthode n’a pas été appelée par la méthode CVssWriter::OnPrepareBackup d’un enregistreur.

Remarques

Le message d’échec défini par SetPrepareForBackupFailureMsg s’applique à tous les fichiers du composant et à tous les sous-composants.

Configuration requise

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

Voir aussi

CVssWriter::OnPrepareBackup

IVssComponentEx

IVssComponentEx::GetPrepareForBackupFailureMsg