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 |
|---|---|
|
La valeur de l’attribut a été retournée. |
|
Aucun message d’échec de PreRestore n’était disponible pour la récupération. |
|
L’une des valeurs de paramètre n’est pas valide. |
|
L’appelant n’a pas de mémoire ou d’autres ressources système. |
|
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::GetPostRestoreFailureMsg