Partager via

Création d’une liste de destinataires

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Une liste de destinataires est une structure ADRLIST qui contient un tableau de structures de valeurs de propriété pour chaque destinataire de message ( destination du message). Un destinataire peut représenter un utilisateur humain, un ordinateur ou un dossier. Tous les messages à envoyer nécessitent au moins un destinataire qui a subi le processus de résolution de noms, un processus permettant de s’assurer que la propriété PR_ENTRYID (PidTagEntryId) est incluse dans le tableau de valeurs de propriété du destinataire.

Les propriétés d’un destinataire sont une combinaison de propriétés de carnet d’adresses et de propriétés de message. Les propriétés du destinataire peuvent s’appliquer à tous les messages d’un destinataire particulier ou uniquement au message actuel. Les fournisseurs de magasin de messages et de transport peuvent définir les propriétés du destinataire.

Chaque destinataire doit avoir un jeu de propriétés de base dans son tableau de valeurs de propriété au moment où le message est prêt à être envoyé. L’ensemble requis de propriétés de destinataire est le suivant :

Ces propriétés sont utilisées pour accéder au destinataire, lui envoyer des messages et le comparer à d’autres. Toutes ces propriétés ne doivent pas être disponibles immédiatement. Vous pouvez ajouter initialement un destinataire sans connaître son identificateur d’entrée, en vous appuyant sur le processus de résolution de noms pour affecter cette propriété. À un moment donné, avant d’envoyer un message, appelez IAddrBook ::ResolveName pour vous assurer que tous les destinataires de votre liste de destinataires sont résolus. Pour plus d’informations, consultez Résolution d’un nom de destinataire.

Les listes de destinataires peuvent être créées à partir d’utilisateurs de messagerie ou d’entrées de liste de distribution dans un conteneur de carnet d’adresses ou à partir d’éléments ponctuels. Les destinataires uniques sont des destinataires qui sont créés en tant qu’entrées temporaires à utiliser uniquement pour traiter un seul message ou en tant qu’entrées à ajouter à un carnet d’adresses personnel. Le format d’un identificateur et d’une adresse d’entrée unique est défini par MAPI. Pour plus d’informations sur ces formats, consultez Adresses ponctuelles et Identificateurs d’entrée unique.

Vous pouvez autoriser les utilisateurs à créer leurs listes de destinataires :

  • Uniquement avec les entrées du carnet d’adresses.

  • Uniquement avec des entrées ponctuelles.

  • Avec une combinaison de destinataires de carnet d’adresses et de destinataires ponctuels.

Pour créer une liste de destinataires à l’aide de la boîte de dialogue Adresse commune

  1. Allouez une structure ADRPARM et un pointeur vers une structure ADRLIST .

  2. Mettez à zéro la mémoire dans la structure ADRPARM et définissez le pointeur ADRLIST sur NULL.

  3. Appelez IAddrBook ::Address pour afficher la boîte de dialogue adresse et remplir la structure ADRPARM .

  4. Appelez IMessage ::ModifyRecipients en passant le pointeur ADRLIST . Cette structure contient les propriétés de chacun des destinataires sélectionnés par l’utilisateur.

Pour créer une liste de destinataires par programmation

  1. Allouez une structure ADRLIST qui contient une structure ADRENTRY pour chacun des destinataires à inclure dans la liste. Faites en sorte que chaque structure ADRENTRY soit suffisamment grande pour contenir chacune des propriétés et PR_RECIPIENT_TYPErequises (PidTagRecipientType).

  2. Pour chaque destinataire, définissez le tableau de valeurs de propriété pour son membre aEntries dans la structure ADRLIST .

  3. Appelez IMessage ::ModifyRecipients avec l’indicateur MODRECIP_ADD défini.