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