IMAPIProp::GetLastError
S’applique à : Outlook 2013 | Outlook 2016
Retourne une structure MAPIERROR qui contient des informations sur l’erreur précédente.
HRESULT GetLastError(
HRESULT hResult,
ULONG ulFlags,
LPMAPIERROR FAR * lppMAPIError
);
Paramètres
Hresult
[in] Handle du code d’erreur généré dans l’appel de méthode précédent.
ulFlags
[in] Masque de bits d’indicateurs qui indique le format du texte retourné dans la structure MAPIERROR pointée par lppMAPIError. L’indicateur suivant peut être défini :
MAPI_UNICODE
Les chaînes doivent être au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, les chaînes doivent être au format ANSI.
lppMAPIError
[out] Pointeur vers un pointeur vers la structure MAPIERROR qui contient des informations sur la version, le composant et le contexte de l’erreur. Le paramètre lppMAPIError peut être défini sur NULL s’il n’y a aucune information d’erreur à retourner.
Valeur renvoyée
S_OK
Les informations d’erreur ont été retournées.
MAPI_E_BAD_CHARWIDTH
Soit l’indicateur MAPI_UNICODE a été défini et l’implémentation ne prend pas en charge Unicode, soit MAPI_UNICODE n’a pas été défini et l’implémentation prend uniquement en charge Unicode.
Remarques
La méthode IMAPIProp ::GetLastError fournit des informations sur un appel de méthode antérieur qui a échoué. Les clients peuvent fournir à leurs utilisateurs des informations détaillées sur l’erreur en incluant les données de la structure MAPIERROR dans une boîte de dialogue.
Toutes les implémentations de GetLastError fournies par MAPI sont des implémentations ANSI, à l’exception de l’implémentation IAddrBook . La méthode GetLastError incluse avec IAddrBook prend en charge Unicode.
Remarques pour les responsables de l’implémentation
Les détails de l’implémentation de cette méthode par un fournisseur de transport distant et les messages retournés par cette méthode dépendent du fournisseur de transport, car les conditions d’erreur particulières qui conduisent à différentes valeurs HRESULT seront différentes pour les différents fournisseurs de transport.
Remarques pour les appelants
Vous pouvez utiliser la structure MAPIERROR pointée par le paramètre lppMAPIError , si GetLastError en fournit une, uniquement si la valeur de retour est S_OK. Parfois, GetLastError ne peut pas déterminer la dernière erreur ou n’a plus rien à signaler sur l’erreur. Dans ce cas, un pointeur vers NULL est retourné dans lppMAPIError à la place.
Pour libérer la mémoire de la structure MAPIERROR , appelez la fonction MAPIFreeBuffer .
Pour plus d’informations sur la méthode GetLastError , consultez Erreurs étendues MAPI.