IMSLogon::GetLastError
S’applique à : Outlook 2013 | Outlook 2016
Retourne une structure MAPIERROR qui contient des informations sur la dernière erreur qui s’est produite pour l’objet de la banque de messages.
HRESULT GetLastError(
HRESULT hResult,
ULONG ulFlags,
LPMAPIERROR FAR * lppMAPIError
);
Paramètres
Hresult
[in] Type de données HRESULT qui contient la valeur d’erreur générée dans l’appel de méthode précédent pour l’objet de magasin de messages.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle le type de chaînes retournées. L’indicateur suivant peut être défini :
MAPI_UNICODE
Les chaînes de la structure MAPIERROR retournées dans le paramètre lppMAPIError sont au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, les chaînes sont au format ANSI.
lppMAPIError
[out] Pointeur vers un pointeur vers la structure MAPIERROR retournée 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 pas DE MAPIERROR à retourner.
Valeur renvoyée
S_OK
L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.
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
Utilisez la méthode IMSLogon ::GetLastError pour récupérer les informations à afficher dans un message à l’utilisateur concernant la dernière erreur retournée par un appel de méthode pour l’objet de la banque de messages.
Pour libérer toute la mémoire allouée par MAPI pour la structure MAPIERROR retournée, les applications clientes doivent appeler uniquement la fonction MAPIFreeBuffer .
La valeur de retour de GetLastError doit être S_OK pour qu’une application utilise MAPIERROR. Même si la valeur de retour est S_OK, un MAPIERROR peut ne pas être retourné. Si l’implémentation ne peut pas déterminer la dernière erreur ou si une erreur MAPIERROR n’est pas disponible pour cette erreur, GetLastError renvoie plutôt un pointeur sur NULL dans lppMAPIError .