The HrMAPIFindFolderEx, HrMAPIOpenFolderEx, HrMAPIFindSubfolderEx, and HrMAPIOpenSubfolderEx functions require the path to a folder as an input parameter. You can express this path in one of two ways:
In the folder path parameter (lpszFolderPath or lpszName), use a series of display names starting with the first folder in the information store. Separate the display names by a character you can specify in the chSep parameter (such as a backslash). For example:
IPM_Subtree\Business\Conferences\Global Summit\Session Materials
Note The Favorites and All Public Folders display names are not valid when used in a path name without an entry identifier. See the following section.
In the folder path parameter (lpszFolderPath or lpszName), use a path that starts with one of the property names listed in the tables in the section Entry Identifiers of Special Folders. Append an @ character to the beginning of the property name. Following the property name, use a series of display names for the subfolders.
For example, the following two path examples point to the same location:
@PR_IPM_PUBLIC_FOLDERS_ENTRYID\Business\Conferences\Global Summit\Session Materials
IPM_Subtree\Business\Conferences\Global Summit\Session Materials
Note The Favorites and All Public Folders display names are valid only when using the @PR_IPM_SUBTREE_ENTRYID property name to begin the path. For example, this path is valid:
@PR_IPM_SUBTREE_ENTRYID\All Public Folders\Business\Conferences\Global Summit\Session Materials