IMsgStore::FinishedMsg
S’applique à : Outlook 2013 | Outlook 2016
Permet au fournisseur de magasin de messages d’effectuer le traitement d’un message envoyé. Cette m�thode est appel�e uniquement par le spouleur MAPI.
HRESULT FinishedMsg(
ULONG ulFlags,
ULONG cbEntryID,
LPENTRYID lpEntryID
);
Paramètres
ulFlags
[in] R�serv� ; doit �tre �gal � z�ro.
cbEntryID
[in] Nombre d’octets dans l’identificateur d’entrée vers lequel pointe le paramètre lpEntryID .
lpEntryID
[in] Pointeur vers l’identificateur d’entrée du message à traiter.
Valeur renvoyée
S_OK
Le traitement du message envoyé a réussi.
MAPI_E_NO_SUPPORT
Le fournisseur de magasin de messages ne prend pas en charge le traitement des messages envoyés. Cette valeur d’erreur est retournée si l’appelant n’est pas le spouleur MAPI.
Remarques
La méthode IMsgStore ::FinishedMsg effectue le traitement sur un message envoyé. Ce traitement peut impliquer la suppression du message, son déplacement vers un autre dossier ou les deux actions. Le type de traitement varie selon que les propriétés PR_DELETE_AFTER_SUBMIT (PidTagDeleteAfterSubmit) et PR_SENTMAIL_ENTRYID (PidTagSentMailEntryId) sont définies.
Remarques pour les responsables de l’implémentation
Dans votre implémentation de FinishedMsg, déverrouillez le message identifié par lpEntryID et effectuez le traitement approprié. Le message cible sera toujours verrouillé ; le spouleur MAPI ne transmet jamais l’identificateur d’entrée d’un message déverrouillé à FinishedMsg.
Il est possible que ni PR_DELETE_AFTER_SUBMIT ni PR_SENTMAIL_ENTRYID ne soit défini, que les deux soient définis, ou que l’un ou l’autre soit défini. Le tableau suivant décrit l’action que vous devez effectuer en fonction des paramètres :
| Propriété | Valeur |
|---|---|
| Si aucune des deux propriétés n’est définie : |
Laissez le message dans le dossier à partir duquel il a été envoyé (généralement la boîte d’envoi). |
| Si les deux propriétés sont définies : |
Déplacez le message vers le dossier indiqué, si vous le souhaitez, puis supprimez-le. |
| Si PR_SENTMAIL_ENTRYID est défini : |
Déplacez le message vers le dossier indiqué. |
| Si PR_DELETE_AFTER_SUBMIT est défini : |
Supprimez le message. |
Une fois que vous avez effectué l’action appropriée, appelez la méthode IMAPISupport ::D oSentMail .