IMAPISupport::GetLastError

Article
03/15/2024

S’applique à : Outlook 2013 | Outlook 2016

Retourne une structure MAPIERROR qui contient des informations sur l’erreur précédente de l’objet de prise en charge.

HRESULT GetLastError(
  HRESULT hResult,
  ULONG ulFlags,
  LPMAPIERROR FAR * lppMAPIError
);

Paramètres

Hresult

[in] Handle de la valeur d’erreur générée dans l’appel de méthode précédent pour l’objet de support.

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 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 si une structure MAPIERROR avec les informations d’erreur appropriées ne peut pas être fournie.

Valeur renvoyée

S_OK

L’appel a réussi et a retourné la ou les valeurs attendues.

MAPI_E_BAD_CHARWIDTH

Soit l’indicateur MAPI_UNICODE a été défini et MAPI ne prend pas en charge Unicode, soit MAPI_UNICODE n’a pas été défini et MAPI prend uniquement en charge Unicode.

Remarques

La méthode IMAPISupport ::GetLastError est implémentée pour tous les objets de support. Les appelants 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.

Remarques pour les appelants

Vous pouvez utiliser le pointeur vers la structure MAPIERROR , si MAPI en fournit une, dans le paramètre lppMAPIError uniquement si GetLastError renvoie S_OK. Parfois, MAPI ne peut pas déterminer la dernière erreur ou il n’a plus rien à signaler sur l’erreur. Dans ce cas, lppMAPIError retourne un pointeur vers NULL à la place.

Pour plus d’informations sur la méthode GetLastError , consultez Erreurs étendues MAPI.

Pour libérer toute la mémoire allouée par MAPI, appelez la fonction MAPIFreeBuffer pour la structure MAPIERROR retournée.

Voir aussi

MAPIERROR
MAPIFreeBuffer
IMAPISupport : Erreurs étendues MAPI IUnknown

Partager via