PidTagMessageAttachments Canonical Property
Published: July 16, 2012
Contains a table of restrictions that can be applied to a contents table to find all messages that contain attachment subobjects that meet the restrictions.
|
Associated properties: |
PR_MESSAGE_ATTACHMENTS |
|
Identifier: |
0x0E13 |
|
Data type: |
PT_OBJECT |
|
Area: |
Message attachment |
This property can be excluded in IMAPIProp::CopyTo operations or included in IMAPIProp::CopyProps 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::OpenProperty method, requesting the IID_IMAPITable interface identifier. Service providers must report it to the IMAPIProp::GetPropList 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::GetAttachmentTable method. For more information, see Attachment Tables.
This property can be used for subobject restriction by specifying it in the SSubRestriction structure. This allows the client to limit the view of a container to messages with attachments meeting given criteria. A message qualifies for viewing if at least one row in its attachments table, that is, one attachment, satisfies the subobject restriction.