| Platform SDK: MAPI |
MAPI defines a few folders that are special because they serve predefined roles as default folders for certain types of messages and usually cannot be deleted, and have special entry identifier properties.
There are eight special folders, some that are part of the IPM subtree. MAPI creates these folders before a client receives access to its message store, after which the client might be able to delete them if necessary. Some message store providers allow deletion while others do not. The following table describes these folders:
| Folder | Description |
|---|---|
| Outbox folder | Holds outgoing IPM messages. |
| Deleted Items folder | Holds IPM messages that are marked for deletion. |
| Sent Items folder | Holds IPM messages that have been sent. |
| IPM root folder | Holds folders for managing IPM messages. |
| Receive folder | Holds incoming messages for a particular message class. |
| Search-results root folder | Holds folders for managing search results. |
| Common views root folder | Holds folders for managing views for the message store. |
| Personal views root folder | Holds folders for managing views for a particular user. |
The first four folders relate to the IPM subtree, a tree of folders created by MAPI 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 only required 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 holds 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 hold 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 machines or between humans and machines — 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 Folder.