Méthode IVssComponent ::GetPostRestoreFailureMsg (vswriter.h)

La méthode GetPostRestoreFailureMsg retourne le message d’échec généré par un writer lors de la gestion de l’événement PostRestore , si IVssComponent ::SetPostRestoreFailureMsg en définit un.

Un writer ou un demandeur peut appeler cette méthode.

Syntaxe

HRESULT GetPostRestoreFailureMsg(
  [out] BSTR *pbstrPostRestoreFailureMsg
);

Paramètres

[out] pbstrPostRestoreFailureMsg

Pointeur vers une chaîne contenant le message d’échec qui décrit une erreur qui s’est produite lors du traitement de l’événement PostRestore .

Valeur retournée

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

Valeur	Signification
S_OK	La valeur de l’attribut a été retournée.
S_FALSE	Aucun message PostRestoreFailure n’était disponible pour être récupéré.
E_INVALIDARG	L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY	L’appelant n’a plus de mémoire ou d’autres ressources système.
VSS_E_INVALID_XML_DOCUMENT	Le document XML n’est pas valide. Pour plus d’informations, consultez le journal des événements. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.

Remarques

L’appelant doit libérer la mémoire détenue par le paramètre pbstrPostRestoreFailureMsg en appelant SysFreeString.

Si SetPostRestoreFailureMsg n’a pas été utilisé pour définir un message d’échec PostRestore , GetPreRestoreFailureMsg retourne S_FALSE.

Configuration requise

Condition requise	Valeur
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

IVssComponent

IVssComponent ::GetPreRestoreFailureMsg

IVssComponent ::SetPostRestoreFailureMsg

IVssComponent ::SetPreRestoreFailureMsg