Propriété canonique PidTagMessageRecipients
S’applique à : Outlook 2013 | Outlook 2016
Contient une table de restrictions qui peut être appliquée à une table de contenu pour rechercher tous les messages qui contiennent des sous-objets de destinataire qui répondent aux restrictions.
| Propriété | Valeur |
|---|---|
| Propriétés associées : |
PR_MESSAGE_RECIPIENTS |
| Identificateur : |
0x0E12 |
| Type de données : |
PT_OBJECT |
| Domaine : |
Messagerie générale |
Remarques
Cette propriété peut être exclue dans les opérations IMAPIProp ::CopyTo ou incluse dans les opérations IMAPIProp ::CopyProps . En tant que propriété de type PT_OBJECT, elle ne peut pas être récupérée avec succès par la méthode IMAPIProp ::GetProps . Son contenu doit être accessible par la méthode IMAPIProp ::OpenProperty , en demandant l’identificateur d’interface IID_IMAPITable . Les fournisseurs de services doivent le signaler à la méthode IMAPIProp ::GetPropList si elle est définie, mais peuvent éventuellement la signaler ou non si elle n’est pas définie.
Pour récupérer le contenu de la table, une application cliente doit appeler la méthode IMessage ::GetRecipientTable .
Cette propriété peut être utilisée pour la restriction de sous-objet en la spécifiant dans la structure SSubRestriction . Cela permet à un client de limiter la vue d’un conteneur aux messages dont les destinataires répondent à des critères donnés. Un message peut être affiché si au moins une ligne dans sa table de destinataires, c’est-à-dire qu’un destinataire satisfait à la restriction de sous-objet.
Note L’utilisation des résultats de restriction de sous-objet équivaut à un appel IMAPISession ::OpenEntry sur chaque message de la table. Selon l’application cliente et le nombre de messages à rechercher, cela peut affecter les performances.
La propriété PR_MESSAGE_ATTACHMENTS (PidTagMessageAttachments) et cette propriété sont similaires dans l’utilisation. Plusieurs propriétés MAPI permettent d’accéder aux tables :
| Propriété | Tableau |
|---|---|
| PR_CONTAINER_CONTENTS (PidTagContainerContents) |
Table des matières |
| PR_CONTAINER_HIERARCHY (PidTagContainerHierarchy) |
Table de hiérarchie |
| PR_FOLDER_ASSOCIATED_CONTENTS (PidTagFolderAssociatedContents) |
Table de contenu associée |
| PR_MESSAGE_ATTACHMENTS (PidTagMessageAttachments) |
Tableau des pièces jointes |
| PR_MESSAGE_RECIPIENTS |
Table de destinataires |
Ressources connexes
Spécifications du protocole
Fournit des références aux spécifications de protocole Exchange Server associées.
Gère l’ordre et le flux pour les transferts de données entre un client et un serveur.
Convertit entre les objets IETF RFC2445, RFC2446 et RFC2447, ainsi que les objets rendez-vous et réunion.
Active la gestion des listes d’autorisation/de blocage et la détermination des courriers indésirables.
Encode et décode les objets message et pièce jointe en une représentation de flux efficace.
Fichiers d’en-tête
Mapidefs.h
Fournit des définitions de type de données.
Mapitags.h
Contient des définitions de propriétés répertoriées en tant que noms alternatifs.