IXPLogon::EndMessage
S’applique à : Outlook 2013 | Outlook 2016
Informe le fournisseur de transport que le spouleur MAPI a terminé son traitement sur un message sortant.
HRESULT EndMessage(
ULONG ulMsgRef,
ULONG FAR * lpulFlags
);
Paramètres
ulMsgRef
[in] Valeur de référence spécifique au message obtenue dans un appel antérieur à la méthode IXPLogon ::SubmitMessage .
lpulFlags
[out] Masque de bits d’indicateurs qui indique au spouleur MAPI ce qu’il doit faire avec le message. Si aucun indicateur n’est défini, le message a été envoyé. Les indicateurs suivants peuvent être définis :
END_DONT_RESEND
Le fournisseur de transport dispose pour l’instant de toutes les informations dont il a besoin sur ce message. Lorsque le fournisseur de transport a besoin de plus d’informations ou qu’il a envoyé le message, il avertit le spouleur MAPI en appelant la méthode IMAPISupport ::SpoolerNotify avec l’indicateur NOTIFY_SENTDEFERRED et en transmettant l’identificateur d’entrée du message.
END_RESEND_LATER
Le fournisseur de transport n’envoie pas le message à l’heure actuelle pour des raisons qui ne sont pas des conditions d’erreur. Le fournisseur de transport doit être rappelé ultérieurement pour envoyer le message.
END_RESEND_NOW
Le fournisseur de transport doit redémarrer le message qui lui a été transmis dans un appel de méthode IMessage ::SubmitMessage .
Valeur renvoyée
S_OK
L’appel a réussi et a retourné la ou les valeurs attendues.
Remarques
Le spouleur MAPI appelle la méthode IXPLogon ::EndMessage après avoir terminé le traitement impliqué dans la fourniture d’informations de remise étendues ou de non-remise.
Une fois cet appel retourné, la valeur dans le paramètre ulMsgRef n’est plus valide pour ce message. Le fournisseur de transport peut réutiliser la même valeur sur un message futur.
Tous les objets que le fournisseur de transport ouvre pendant le transfert d’un message doivent être libérés avant le retour de l’appel EndMessage , à l’exception de l’objet de message que le spouleur MAPI transmet au fournisseur de transport. L’objet de message passé par le spouleur MAPI n’est pas valide après l’appel EndMessage .