Partager via


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

Spécifications du protocole

[MS-OXPROPS]

Fournit des références aux spécifications de protocole Exchange Server associées.

[MS-OXCFXICS]

Gère l’ordre et le flux pour les transferts de données entre un client et un serveur.

[MS-OXCICAL]

Convertit entre les objets IETF RFC2445, RFC2446 et RFC2447, ainsi que les objets rendez-vous et réunion.

[MS-OXCSPAM]

Active la gestion des listes d’autorisation/de blocage et la détermination des courriers indésirables.

[MS-OXTNEF]

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.

Voir aussi

Propriétés MAPI

Propriétés canoniques MAPI

Mappage des noms de propriétés canoniques aux noms MAPI

Mappage des noms MAPI aux noms de propriétés canoniques