Platform SDK: MAPI

PR_CONTAINER_HIERARCHY

The PR_CONTAINER_HIERARCHY property contains an embedded hierarchy table object that provides information about the child containers.

Quick Info

Header file: MAPITAGS.H
Must be exposed by: Address book container and folder objects
Identifier: 0x360E
Property type: PT_OBJECT
Property tag: 0x360E000D

Remarks

The PR_CONTAINER_HIERARCHY 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 can optionally report it or not if it is not set.

To retrieve table contents, a client application should call the IMAPIContainer::GetHierarchyTable method. For more information, see Hierarchy Tables.

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