IMAPISupport::PrepareSubmit

Article
08/19/2024

S’applique à : Outlook 2013 | Outlook 2016

Prépare un message à envoyer au spouleur MAPI.

HRESULT PrepareSubmit(
LPMESSAGE lpMessage,
ULONG FAR * lpulFlags
);

Paramètres

lpMessage

[in] Pointeur vers le message à préparer.

lpulFlags

[in, out] En entrée, le paramètre lpulFlags est réservé et doit être égal à zéro. En sortie, lpulFlags doit avoir la valeur NULL.

Valeur renvoyée

S_OK

Le message a été correctement préparé.

Remarques

La méthode IMAPISupport ::P repareSubmit est implémentée pour les objets de prise en charge du fournisseur de magasins de messages. Les fournisseurs de magasins de messages appellent PrepareSubmit dans leur implémentation de la méthode IMessage ::SubmitMessage pour préparer un message à envoyer au spouleur MAPI.

PrepareSubmit est utilisé pour gérer les messages dont l’indicateur MSGFLAG_RESEND est défini dans leur propriété PR_MESSAGE_FLAGS (PidTagMessageFlags). MSGFLAG_RESEND est défini pour les messages qui incluent une demande à renvoyer en cas d’échec d’une transmission initiale. PrepareSubmit détermine les destinataires de la liste des destinataires qui ont reçu le message et ceux qui ne l’ont pas reçu.

Pour accéder à la liste des destinataires, PrepareSubmit appelle la méthode IMessage ::GetRecipientTable du message. Pour récupérer les données du destinataire, PrepareSubmit appelle la méthode IMAPITable ::QueryRows de la table de destinataires. Pour chaque ligne de la table, PrepareSubmit vérifie la propriété PR_RECIPIENT_TYPE (PidTagRecipientType) et effectue l’une des actions suivantes :

Si l’indicateur MAPI_SUBMITTED est défini, PrepareSubmit efface l’indicateur et définit la propriété PR_RESPONSIBILITY (PidTagResponsibility) sur FALSE.
Si l’indicateur MAPI_SUBMITTED n’est pas défini, PrepareSubmit modifie PR_RECIPIENT_TYPE en MAPI_P1 et définit PR_RESPONSIBILITY sur TRUE.

Remarques pour les appelants

Avant d’appeler PrepareSubmit, veillez à appeler la méthode IMAPISupport ::SpoolerNotify et à définir l’indicateur NOTIFY_READYTOSEND dans le paramètre ulFlags . L’appel SpoolerNotify doit être effectué une fois par session avant l’appel à PrepareSubmit. SpoolerNotify synchronise le spouleur MAPI et garantit que tous les fournisseurs de transport nécessaires sont connectés et que leurs types d’adresses sont inscrits.

Voir aussi

IMAPIFolder::GetMessageStatus
IMessage::SubmitMessage
IMAPISupport : IUnknown

Partager via