PidTagMessageAttachments Canonical Property

Applies to: Office 2010 | Outlook 2010 | Visual Studio

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

Remarks

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.

Protocol Specifications

  • [MS-OXCDATA]
    Defines the basic data structures that are used in remote operations.

  • [MS-OXCFXICS]
    Defines the basic data structures that are used in remote operations.

  • [MS-OXCICAL]
    Converts between IETF RFC2445, RFC2446, and RFC2447, and appointment and meeting objects.

Header Files

  • Mapidefs.h
    Provides data type definitions.

  • Mapitags.h
    Contains definitions of properties listed as alternate names.

See Also

Concepts

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names