MAPI Properties

Description: Contains a constant that indicates the folder type.
Property ID: $3601
Property type: PT_LONG
Area: MAPI container

This property can have exactly one of the following values:

FOLDER_GENERIC - A generic folder that contains messages and other folders.
FOLDER_ROOT - The root folder of the folder hierarchy table, that is, a folder that has no parent folder.
FOLDER_SEARCH - A folder that contains the results of a search, in the form of links to messages that meet search criteria.

The root of a message store should not be confused with the root of the interpersonal message (IPM) subtree in that store. The store's root folder, which has no parent, is obtained by calling the IMsgStore::OpenEntry method with a null entry identifier. The IPM subtree's root folder, which does have a parent, is obtained by using the value of the PR_IPM_SUBTREE_ENTRYID (PidTagIpmSubtreeEntryId) property for the OpenEntry call.

MAPI allows only one root folder per message store. This folder contains messages and other folders. The root folder's PR_PARENT_ENTRYID (PidTagParentEntryId) property contains the folder's own entry identifier.

The information in a search-results folder is mainly stored in its contents table, which contains the same columns as a typical contents table, as well as two extra columns identifying the folder in which each message was found: PR_PARENT_DISPLAY (PidTagParentDisplay) (display name, required) and this property (entry identifier, optional).