IMAPISupport::ReadReceipt

Article
03/15/2024

S’applique à : Outlook 2013 | Outlook 2016

Génère un rapport lu ou non lu pour un message.

HRESULT ReadReceipt(
ULONG ulFlags,
LPMESSAGE lpReadMessage,
LPMESSAGE FAR * lppEmptyMessage
);

Paramètres

ulFlags

[in] Masque de bits d’indicateurs qui contrôle la façon dont le rapport lu ou non lu est généré. L’indicateur suivant peut être défini :

MAPI_NON_READ

Un rapport non lu est généré. Si MAPI_NON_READ n’est pas défini, un rapport de lecture est généré.

lpReadMessage

[in] Pointeur vers le message sur lequel le rapport doit être généré.

lppEmptyMessage

[in, out] Lors de l’entrée, lppEmptyMessage pointe vers un pointeur vers un message vide. Dans la sortie, lppEmptyMessage pointe vers un pointeur vers le message de rapport.

Valeur renvoyée

S_OK

Le rapport a été généré avec succès.

Remarques

La méthode IMAPISupport ::ReadReceipt est implémentée uniquement pour les objets de prise en charge du fournisseur de magasins de messages. Les fournisseurs de magasins de messages appellent ReadReceipt pour indiquer à MAPI de générer un rapport en lecture ou non lu pour le message vers lequel pointe le paramètre lpReadMessage .

Remarques pour les appelants

Appelez ReadReceipt lorsque la propriété PR_READ_RECEIPT_REQUESTED (PidTagReadReceiptRequested) est définie et que l’une des conditions suivantes est remplie :

Le message a été lu.
Le message a été déplacé.
Le message a été copié.
La méthode IMessage ::SetReadFlag du message a été appelée.

N’appelez pas ReadReceipt lorsqu’un message est supprimé.

Un rapport lu ou non lu ne doit être envoyé qu’une seule fois pour un message. Effectuez le suivi des status de lecture d’un message et n’envoyez pas plusieurs rapports pour un seul message.

Si le paramètre lppEmptyMessage pointe vers un message de rapport valide lorsque MAPI est retourné à partir de ReadReceipt, appelez la méthode IMessage ::SubmitMessage pour envoyer le message, puis relâchez le pointeur en appelant sa méthode IUnknown :s :Release .

Si ReadReceipt échoue, le message doit être libéré sans être envoyé. Si vous stockez les status de lecture du message, vous pouvez tenter de générer le rapport lu ou non lu ultérieurement.

Vous pouvez masquer ou afficher les rapports en lecture et non lus générés par les magasins dans vos dossiers. Le stockage de rapports en lecture et non lus dans des dossiers masqués vous permet d’implémenter une sécurité renforcée.

Voir aussi

IMAPIFolder::DeleteMessages
IMessage::SubmitMessage
Propriété canonique PidTagReadReceiptRequested
IMAPISupport : IUnknown

Partager via