Partager via

Gestion d’un message entrant

S’applique à : Outlook 2013 | Outlook 2016

Un message entrant est un message qui a été envoyé sur un ou plusieurs systèmes de messagerie. Il peut avoir été envoyé uniquement à vous ou à de nombreux autres destinataires. Les messages entrants sont placés dans un dossier de réception désigné pour contenir les messages d’une classe particulière. Vous pouvez configurer un dossier de réception différent pour chaque classe de message que vous gérez ou utiliser un dossier pour toutes les classes.

Si vous vous êtes inscrit aux nouvelles notifications par courrier auprès de la banque de messages, vous serez averti chaque fois qu’un message est placé dans un dossier de réception. Si vous n’êtes pas inscrit aux nouvelles notifications par courrier électronique, vous devez ouvrir régulièrement le dossier de réception approprié pour case activée manuellement l’arrivée de nouveaux messages.

Les clients s’inscrivent pour les nouvelles notifications par courrier en définissant les paramètres sur IMsgStore ::Advise comme suit :

  • Définissez cbEntryID sur 0.

  • Définissez lpEntryID sur NULL.

  • Définissez ulEventMask sur fnevNewMail.

Le paramètre lpNotifications dans l’appel à votre méthode IMAPIAdviseSink ::OnNotify pointe vers une structure NEWMAIL_NOTIFICATION qui contient des informations sur le message entrant, telles que sa classe de message, son identificateur d’entrée, l’identificateur d’entrée de son dossier parent et le contenu de sa propriété PR_MESSAGE_FLAGS . Pour plus d’informations sur l’inscription et la gestion des notifications, consultez IMAPIAdviseSink ::OnNotify, NEWMAIL_NOTIFICATION, PR_MESSAGE_FLAGS (PidTagMessageFlags) et Gestion des notifications.

Avant d’afficher un message entrant à un utilisateur, déterminez si sa classe de message est une classe prise en charge par votre client. Si ce n’est pas le cas, ignorez le message. Si la classe est prise en charge, vous pouvez ouvrir et afficher le message avec un formulaire approprié pour la classe de message du message. Le choix des formulaires est basé sur la classe de message. Les messages qui appartiennent à la classe IPM utilisent un formulaire par défaut implémenté par MAPI. Les messages qui appartiennent à des classes personnalisées définies par les clients peuvent utiliser des formulaires spécialisés définis par le client ou le formulaire MAPI par défaut.

Ouvrir et afficher un message entrant

  1. Appelez IMsgStore ::GetReceiveFolder pour récupérer l’identificateur d’entrée du dossier receive pour la classe de message du message et passer cet identificateur d’entrée à IMsgStore ::OpenEntry pour ouvrir le dossier. Pour plus d’informations, consultez IMsgStore ::GetReceiveFolder, IMsgStore ::OpenEntry et Ouverture d’un dossier de magasin de messages.

  2. Appelez la méthode IMAPIContainer ::GetContentsTable du dossier de réception pour récupérer sa table de contenu. Pour plus d’informations, consultez IMAPIContainer ::GetContentsTable. Appelez la méthode IMAPITable ::QueryRows de la table pour récupérer toutes les lignes de la table. Pour plus d’informations, consultez IMAPITable ::QueryRows and Contents Tables. Pour plus d’informations sur l’affichage d’une table de contenu, consultez Affichage d’une table de contenu de dossier.

  3. Si votre client est interactif, autorisez l’utilisateur à sélectionner un message dans la table et à déterminer le formulaire à utiliser pour afficher ce message. Les clients peuvent utiliser le formulaire par défaut fourni par MAPI ou un formulaire personnalisé. Pour plus d’informations, consultez Gestion des formulaires MAPI.

  4. Appelez IMsgStore ::OpenEntry pour ouvrir le message. Pour plus d’informations, consultez Ouverture d’un message.

  5. Traitez le texte du message. Pour plus d’informations, consultez Ouverture du texte du message.

  6. Affiche chacune des pièces jointes du message. Pour plus d’informations, consultez Rendu d’une pièce jointe en texte brut ou Rendu d’une pièce jointe en texte RTF.

  7. Ouvrez une pièce jointe si vous le souhaitez. Pour plus d’informations, consultez Ouverture d’une pièce jointe.

Dans cette section