PidTagMessageRecipients (kanonische Eigenschaft)

Artikel
04/04/2023

Gilt für: Outlook 2013 | Outlook 2016

Enthält eine Tabelle mit Einschränkungen, die auf eine Inhaltstabelle angewendet werden können, um alle Nachrichten zu finden, die Empfängerunterobjekte enthalten, die die Einschränkungen erfüllen.

Eigenschaft	Wert
Zugeordnete Eigenschaften:	PR_MESSAGE_RECIPIENTS
Kennung:	0x0E12
Datentyp:	PT_OBJECT
Bereich:	Allgemeine Nachrichten

Hinweise

Diese Eigenschaft kann in IMAPIProp::CopyTo-Vorgängen ausgeschlossen oder in IMAPIProp::CopyProps-Vorgänge eingeschlossen werden. Als Eigenschaft vom Typ PT_OBJECT kann sie nicht erfolgreich von der IMAPIProp::GetProps-Methode abgerufen werden. Auf den Inhalt sollte über die IMAPIProp::OpenProperty-Methode zugegriffen werden, die den IID_IMAPITable Schnittstellenbezeichner anfordert. Dienstanbieter müssen sie an die IMAPIProp::GetPropList-Methode melden, wenn sie festgelegt ist, können sie aber optional melden oder nicht, wenn sie nicht festgelegt ist.

Zum Abrufen von Tabelleninhalten sollte eine Clientanwendung die IMessage::GetRecipientTable-Methode aufrufen.

Diese Eigenschaft kann für die Einschränkung von Unterobjekten verwendet werden, indem sie in der SSubRestriction-Struktur angegeben wird. Dadurch kann ein Client die Ansicht eines Containers auf Nachrichten beschränken, deren Empfänger bestimmte Kriterien erfüllen. Eine Nachricht kann angezeigt werden, wenn mindestens eine Zeile in der Empfängertabelle, d. h. ein Empfänger, die Einschränkung des Unterobjekts erfüllt.

Hinweis Die Verwendung von Unterobjekteinschränkungsergebnissen entspricht einem IMAPISession::OpenEntry-Aufruf für jede Nachricht in der Tabelle. Abhängig von der Clientanwendung und der Anzahl der zu durchsuchenden Nachrichten kann sich dies auf die Leistung auswirken.

Die PR_MESSAGE_ATTACHMENTS -Eigenschaft (PidTagMessageAttachments) und diese Eigenschaft sind in der Verwendung ähnlich. Mehrere MAPI-Eigenschaften ermöglichen den Zugriff auf Tabellen:

Eigenschaft	Table
PR_CONTAINER_CONTENTS (PidTagContainerContents)	Inhaltstabelle
PR_CONTAINER_HIERARCHY (PidTagContainerHierarchy)	Hierarchietabelle
PR_FOLDER_ASSOCIATED_CONTENTS (PidTagFolderAssociatedContents)	Tabelle mit zugeordneten Inhalten
PR_MESSAGE_ATTACHMENTS (PidTagMessageAttachments)	Anlagetabelle
PR_MESSAGE_RECIPIENTS	Empfängertabelle