MAPI Special Folders

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

MAPI defines a few folders that are special because they serve predefined roles as default folders for certain types of messages. These special folders typically cannot be deleted, and they have special entry identifier properties.

There are eight special folders, some that are part of the interpersonal message (IPM) subtree. MAPI creates these folders before a client receives access to its message store, after which the client might be able to delete the folders, if necessary. Some message store providers allow deletion, while others do not. The following table describes these folders.

MAPI Folders

Folder

Description

Outbox folder

Contains outgoing IPM messages.

Deleted Items folder

Contains IPM messages that are marked for deletion.

Sent Items folder

Contains IPM messages that have been sent.

IPM root folder

Contains folders for managing IPM messages.

Receive folder

Contains incoming messages for a particular message class.

Search-results root folder

Contains folders for managing search results.

Common-views root folder

Contains folders for managing views for the message store.

Personal-views root folder

Contains folders for managing views for a particular user.

The first four folders relate to the IPM subtree, a tree of folders that MAPI creates when a message store is initialized. Default message stores for interactive messaging clients always include the IPM folder subtree and the other special folders in their folder hierarchy. Non-default message stores are required only to support the search-results root folder, the IPM subtree root folder, the Deleted Items folder, and the receive folder. To ensure that the IPM subtree folders exist and are valid, clients can call the HrValidateIPMSubtree function. HrValidateIPMSubtree checks the folders and recreates them if there is a problem.

The root folders for search results, common views, and personal views are not part of the IPM subtree; these folders are created in the root folder for the message store. The search-results root folder contains folders that support contents tables with messages that satisfy a set of search criteria. Although clients are allowed to create search-results folders in any folder, most clients designate a single root folder to be the parent of all the search-results folders created during the session.

The common-views and personal-views root folders contain messages that describe views, or preferred ways of presenting message and folder data. The common-views root folder contains views that clients can use with any folder in the message store; the personal-views folder contains views that have been defined by a particular user for a particular folder or folders.

Clients that work with IPM messages should create all folders and messages under the IPM subtree root folder, rather than the root folder of the message store. This gives non-IPM clients — the clients that deal with messages exchanged between computers or between humans and computers — an easy way to hide their messages from IPM clients.

MAPI assigns special entry identifier properties for these special folders. For a list of the special folder entry identifiers, see Opening a Message Store Folder.

Outlook Special Folders

Outlook special folders are identified by their entry IDs that are stored in the Inbox folder and the root folder for the message store.

Folder

The property to set

Calendar

PR_IPM_APPOINTMENT_ENTRYID (PidTagIpmAppointmentEntryId)

Contacts

PR_IPM_CONTACT_ENTRYID (PidTagIpmContactEntryId)

Journal

PR_IPM_JOURNAL_ENTRYID (PidTagIpmJournalEntryId)

Notes

PR_IPM_NOTE_ENTRYID (PidTagIpmNoteEntryId)

Tasks

PR_IPM_TASK_ENTRYID (PidTagIpmTaskEntryId)

Drafts

PR_IPM_DRAFTS_ENTRYID (PidTagIpmDraftsEntryId)

See Also

Concepts

MAPI Folders