IMAPISupport::StatusRecips
S’applique à : Outlook 2013 | Outlook 2016
Génère des rapports de remise et de non-remise.
HRESULT StatusRecips(
LPMESSAGE lpMessage,
LPADRLIST lpRecipList
);
Paramètres
lpMessage
[in] Pointeur vers le message pour lequel le rapport doit être généré.
lpRecipList
[in] Pointeur vers une structure ADRLIST qui décrit les destinataires du message pointé par lpMessage.
Valeur renvoyée
S_OK
Le rapport a été généré avec succès.
MAPI_W_ERRORS_RETURNED
L’appel a réussi dans l’ensemble, mais il n’existe aucune option de destinataire pour ce type de destinataire. Lorsque cet avertissement est retourné, l’appel doit être géré comme ayant réussi. Pour tester cet avertissement, utilisez la macro HR_FAILED . Pour plus d’informations, consultez Utilisation de macros pour la gestion des erreurs.
Remarques
La méthode IMAPISupport ::StatusRecips est implémentée pour les objets de prise en charge du fournisseur de transport. Les fournisseurs de transport appellent StatusRecips pour demander que MAPI envoie un rapport de remise ou de non-remise à un ensemble d’un ou plusieurs destinataires d’un message.
Remarques pour les appelants
Vous pouvez appeler StatusRecips plusieurs fois pendant le traitement d’un message. Toutefois, si vous appelez StatusRecips pour un message ouvert, faites de votre mieux pour collecter toutes les informations de remise et de non-remise pour les destinataires du message et appeler StatusRecips pour cette liste de destinataires. Un point de collection unique est important, car plusieurs appels StatusRecips pour un seul destinataire peuvent entraîner l’envoi de plusieurs rapports identiques.
Stockez les propriétés liées à la remise ou à la non-remise des messages dans la structure ADRLIST indiquée par le paramètre lpRecipList . Pour obtenir la liste complète des propriétés obligatoires et facultatives pour les rapports de remise et les rapports non remis, consultez Propriétés des messages de rapport obligatoires et Propriétés facultatives des messages de rapport.
Allouez de la mémoire pour la structure ADRLIST dans lpRecipList à l’aide des fonctions MAPIAllocateBuffer et MAPIAllocateMore . MAPI libère la mémoire en appelant la fonction MAPIFreeBuffer uniquement si StatusRecips réussit.
Pour obtenir une vue d’ensemble des rapports de remise et de non-remise, consultez Messages de rapport MAPI.