MAPI 搜索文件夹

适用于:Outlook 2013 | Outlook 2016

搜索结果文件夹保存指向通用文件夹中的邮件的链接,而不是实际邮件。 客户端通过调用 IMAPIFolder::CreateFolder 方法创建搜索结果文件夹,并将 FOLDER_SEARCH 作为 ulFolderType 参数。 客户端通过设置和应用搜索条件(筛选出具有特定特征的邮件的规则)来填充搜索结果文件夹。 使用 IMAPIContainer::SetSearchCriteria 方法设置搜索条件。 客户端生成一个或多个 SRestriction 结构来表示要应用的搜索条件,并将其传递给 SetSearchCriteriaSetSearchCriteria 还指定一个文件夹列表,这些文件夹指示搜索域,以及一组用于控制搜索执行方式的标志。

SetSearchCriteria 标识与指定限制匹配的消息。 所选邮件 (满足条件的邮件) 在搜索结果文件夹中显示为链接。 当客户端调用 IMAPIContainer::GetContentsTable 方法来访问搜索结果文件夹的目录时,所选邮件将显示在表中。 搜索结果文件夹的内容表包含的列与泛型文件夹的内容表相同。 但是,对于搜索结果文件夹, PR_PARENT_ENTRYID (PidTagParentEntryId) 属性指定链接邮件所在的文件夹的条目标识符。 搜索结果文件夹不被视为父文件夹。

搜索结果文件夹具有以下限制:

  • 修改搜索结果文件夹内容的唯一方法是调用 SetSearchCriteria。 有关 SetSearchCriteria 实现的详细信息,请参阅知识库文章 260322:如何使用 SetSearchCriteria 方法搜索文件夹

  • 邮件无法移动或复制到搜索结果文件夹中。

  • 搜索结果文件夹不能包含子文件夹。

  • 客户端不能将搜索结果文件夹设置为搜索的主题。

但是,可以修改搜索结果文件夹的属性并使用它删除邮件。 从搜索结果文件夹中删除邮件时,实际上会从实际文件夹中删除该邮件。 但是,删除搜索结果文件夹本身对内部邮件没有影响;它们将保留在其通用文件夹中。

另请参阅

MAPI 文件夹