Outlook待办文件夹未显示红色标记邮件（C++/VC++ MAPI插件问题）

一、控制待办标记的核心MAPI属性与操作 #

• 红色待办标记对应的关键MAPI属性是**PR_FLAG_STATUS**（属性标签：0x10900003）：
  • 将其设置为FLAG_STATUS_MARKED（数值为1），即可把邮件标记为待办项；
  • 若需要设置截止日期、完成状态，还需配合**PR_FLAG_DUE_BY（0x10910040，存储截止时间）、PR_FLAG_COMPLETE**（0x10920003，标记是否完成）这两个属性。
• 修改属性后，必须调用IMAPIProp::SaveChanges函数提交修改，否则Outlook无法感知到属性变更。
• 注意：操作时要确保修改的是收件箱中实际存在的邮件实例，而非临时创建的对象。

二、Outlook待办文件夹的展示机制 #

• 待办文件夹是虚拟筛选文件夹，并非物理存储位置：
  • 它通过内置筛选规则，自动收集所有满足条件的项目：包括PR_FLAG_STATUS为FLAG_STATUS_MARKED且PR_FLAG_COMPLETE为FALSE的邮件，同时也涵盖任务、已标记联系人等其他类型项。
  • Outlook会实时监听邮箱内项目的属性变化，当邮件的标记属性被正确修改并保存后，待办文件夹的筛选器会自动更新，将该邮件加入列表。
• 若修改后未显示，常见排查点：
  • 遗漏SaveChanges调用，导致属性变更未持久化；
  • PR_FLAG_STATUS取值错误（比如误设为FLAG_STATUS_CLEARED）；
  • MAPI会话未同步，可尝试调用IMAPIFolder::GetContentsTable刷新文件夹内容，触发Outlook重新执行筛选。

内容的提问来源于stack exchange，提问作者Manish