适用于:Outlook 2013 | Outlook 2016
每个邮件存储提供程序都必须向客户端应用程序提供顶级 IMAPIFolder 界面。 顶级文件夹对应整个邮件存储;它提供用户看作邮件存储内容的文件夹的访问权限。 此外,顶级文件夹通常用作 IPC 邮件的默认接收文件夹和发送已读报表的文件夹。 邮件存储提供程序还必须向客户端应用程序提供 IPM 子树 — 用于包含 IPM 邮件的文件夹集。
客户端应用程序可以通过为 cbEntryId 和 lpEntryId 参数分别调用 0 和 NULL 的 IMsgStore::OpenEntry 方法来打开顶级文件夹。 但是,在大多数情况下,客户端应用程序会打开包含 IPM 邮件的文件夹集。
获取邮件存储的 IPM 文件夹树中的文件夹列表
使用 MAPI 会话来调用 IMAPISession::OpenMsgStore 方法。
使用结果邮件数据库指针来调用 PR_IPM_SUBTREE_ENTRYID (PidTagIpmSubtreeEntryId) 属性的 IMAPIProp::GetProps 方法。
使用条目标识符调用 IMsgStore::OpenEntry 方法以获取 IMAPIFolder 指针。
调用 IMAPIContainer::GetHierarchyTable 方法以获取文件夹内容表。
调用 IMAPITable::QueryRows 方法以列出顶级文件夹中的文件夹。
MAPI 客户端使用这些文件夹访问邮件存储中的其他文件夹对象和邮件对象。 IMAPIFolder 及其父界面 IMAPIContainer 包含邮件存储提供程序必须实现的方法,以使用邮件对象填充文件夹并响应客户端操作邮件的请求。