IPersistMessage::GetLastError
S’applique à : Outlook 2013 | Outlook 2016
Retourne une structure MAPIERROR qui contient des informations sur l’erreur précédente dans l’objet de formulaire.
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.
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 une 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 le formulaire ne peut pas fournir les informations appropriées pour une structure MAPIERROR .
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 le fournisseur de carnet d’adresses ne prend pas en charge Unicode, soit MAPI_UNICODE n’a pas été défini et le fournisseur de carnet d’adresses prend uniquement en charge Unicode.
Remarques
Les objets Form implémentent la méthode IPersistMessage ::GetLastError pour fournir des informations sur un appel de méthode antérieur qui a échoué. Les visionneuses de formulaires 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.
Un appel à GetLastError n’affecte pas l’état du formulaire. Lorsque GetLastError est retourné, le formulaire reste dans l’état dans lequel il se trouvait avant l’appel.
Remarques pour les appelants
Vous pouvez utiliser la structure MAPIERROR , si le formulaire en fournit une, qui est pointée par le paramètre lppMAPIError uniquement si GetLastError renvoie S_OK. Parfois, le formulaire ne peut pas déterminer la dernière erreur ou n’a rien de plus à signaler sur l’erreur. Dans ce cas, le formulaire renvoie un pointeur vers NULL dans lppMAPIError à la place.
Pour plus d’informations sur la méthode GetLastError , consultez Erreurs étendues MAPI.