PR_MESSAGE_RECIPIENTS 

The PR_MESSAGE_RECIPIENTS property contains a table of restrictions that can be applied to a contents table to find all messages that contain recipient subobjects meeting the restrictions.

Quick Info

Remarks

The PR_MESSAGE_RECIPIENTS property can be excluded in IMAPIProp::CopyTo1_YJNNR operations or included in IMAPIProp::CopyPropsJ9YC90 operations. As a property of type PT_OBJECT, it cannot be successfully retrieved by the IMAPIProp::GetProps method; its contents should be accessed by the IMAPIProp::OpenPropertyLFSSYS method, requesting the IID_IMAPITable interface identifier. Service providers must report it to the IMAPIProp::GetPropListB2KAAM method if it is set, but may optionally report it or not if it is not set.

To retrieve table contents, a client application should call the IMessage::GetRecipientTable12Z640H method. For more information, see Recipient TablesNM5UHO.

PR_MESSAGE_RECIPIENTS can be used for subobject restriction by specifying it in the SSubRestriction..BR79 structure. This enables a client to limit the view of a container to messages with recipients meeting given criteria. A message qualifies for viewing if at least one row in its recipient table, that is, one recipient satisfies the subobject restriction.

Note  Using subobject restriction results is the equivalent of an IMAPISession::OpenEntrySU4OVY call on every message in the table. Depending on the client application and the number of messages to be searched, it can affect performance.

The PR_MESSAGE_ATTACHMENTS and PR_MESSAGE_RECIPIENTS properties are similar in usage. Several MAPI properties provide access to tables: