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

La méthode GetPreRestoreFailureMsg récupère le message d’erreur généré par un enregistreur lors de la gestion de l’événement PreRestore , si IVssComponent::SetPreRestoreFailureMsg en définit un.

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

Syntaxe

HRESULT GetPreRestoreFailureMsg(
  [out] BSTR *pbstrPreRestoreFailureMsg
);

Paramètres

[out] pbstrPreRestoreFailureMsg

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

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 d’échec de PreRestore n’était disponible pour la récupération.
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_INVALID_XML_DOCUMENT	Le document XML n’est pas valide. Consultez le journal des événements pour plus d’informations. 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 pbstrPreRestoreFailureMsg en appelant SysFreeString.

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

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

IVssComponent

IVssComponent::GetPostRestoreFailureMsg

IVssComponent::SetPostRestoreFailureMsg

IVssComponent::SetPreRestoreFailureMsg