Platform SDK: MAPI

PR_FOLDER_ASSOCIATED_CONTENTS

The PR_FOLDER_ASSOCIATED_CONTENTS property contains an embedded contents table object that provides information about the associated contents table.

Quick Info

Header file: MAPITAGS.H
Must be exposed by: Folder objects
Identifier: 0x3610
Property type: PT_OBJECT
Property tag: 0x3610000D

Remarks

The associated contents table represents a subfolder that does not appear in the standard contents table. It contains the folder's associated, or hidden, messages.

The PR_FOLDER_ASSOCIATED_CONTENTS 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, client applications should call the IMAPIContainer::GetContentsTable method. For more information on folder contents tables, see Contents Tables and Displaying a Folder Contents Table.

The PR_CONTAINER_CONTENTS, PR_CONTAINER_HIERARCHY, and PR_FOLDER_ASSOCIATED_CONTENTS properties are similar in usage. Several MAPI properties provide access to tables:

Property Table
PR_CONTAINER_CONTENTS Contents table
PR_CONTAINER_HIERARCHY Hierarchy table
PR_FOLDER_ASSOCIATED_CONTENTS Associated contents table
PR_MESSAGE_ATTACHMENTS Attachment table
PR_MESSAGE_RECIPIENTS Recipient table

See Also

Table Access Properties, PR_ASSOC_CONTENT_COUNT