C#开发Outlook插件：如何可靠检测启动后Send/Receive操作完成

你之前尝试的所有方案失败，本质上都是踩了Outlook开发的几个通用坑：

• 手动调用Session.SendAndReceive()本身就是异步非阻塞方法，无论传什么参数都会立刻返回，不可能等待收发流程跑完，这是COM接口的固有设计特性。
• NewMailEx/NewMail在启动场景下不触发，通常是两个原因：一是插件加载时机晚于Outlook启动后的首轮新邮件推送，事件已经发送完毕才完成订阅；二是COM事件的订阅引用没有被强持有，被.NET垃圾回收机制回收，导致后续事件全部失效。
• AppFolders.SyncEnd触发时机过早，是因为这个事件仅代表同步会话的网络连接断开，此时本地MAPI存储还在处理邮件落盘、索引生成流程，并没有完成全量收发动作。
• 遍历SyncObjects注册的事件完全不触发，核心原因是局部方法里创建的SyncObject COM实例没有类级别的强引用，被.NET运行时回收，对应的事件订阅自然就失效了。

具体落地实现 #

1. 修正事件订阅的引用持有逻辑 #

所有和同步相关的COM对象必须提升为插件类的私有字段，不能写在局部方法里用完就丢，否则一定会被GC回收导致事件失效：

// 写在ThisAddIn类的字段区，不要写在Startup局部方法里
private Outlook.NameSpace _mapiNamespace;
private Outlook.SyncObjects _allSyncObjects;
private List<Outlook.SyncObject> _trackedSyncObjects = new List<Outlook.SyncObject>();
private int _pendingSyncCount = 0;
private bool _initialSyncCompleted = false;

2. 绑定正确的启动监听节点 #

不要在插件Startup事件里直接初始化同步监听——此时Outlook的MAPI存储还没完成登录初始化，拿到的对象都是未就绪状态。要等NameSpace.LogonComplete事件触发后，再启动同步逻辑：

• 在Startup事件里先获取Application.Session实例，把它存在上面的私有字段中持有
• 订阅NameSpace.LogonComplete事件，在这个事件回调里再做初始化：
  • 获取全量SyncObjects集合，遍历每个SyncObject
  • 把每个SyncObject加入_trackedSyncObjects类级列表持有，避免被回收
  • 为每个对象绑定SyncStart/SyncEnd事件：
    • 在SyncStart回调里给_pendingSyncCount加1计数，只把真正启动的同步会话纳入等待范围
    • 在SyncEnd回调里给_pendingSyncCount减1计数，当计数归0时代表所有同步会话的网络连接已断开
• 初始化完成后，调用_mapiNamespace.SendAndReceive(false)手动触发全量收发流程

3. 补全SyncEnd后的时序校验 #

SyncEnd触发不代表真的完成了收发流程，必须加两层校验才能触发后续检测动作：

• 当_pendingSyncCount归0时，启动一个延时2~3秒的本地等待（可以用System.Threading.Timer实现），给MAPI存储留足邮件落盘、索引写入的时间
• 等待结束后，遍历所有已连接的Stores，检查每个Store的索引状态，只要有一个Store处于忙碌的索引状态，就继续轮询等待，直到所有Store全部空闲，再触发新邮件检测逻辑

4. 兜底补漏启动阶段的邮件漏检 #

即使等LogonComplete再启动逻辑，依然可能有部分新邮件在插件加载完成前就已经落到本地存储，事件没被捕获到。所以在首次全量校验完成后，要主动遍历收件箱的邮件集合，用Items.Restrict()方法筛选出Outlook启动时间点之后收到的所有邮件，补全事件没覆盖到的检测范围。

注意：如果用户使用Exchange缓存模式，Outlook默认会先下载邮件头、再后台异步拉取完整邮件内容，上面的Store索引状态校验会自动覆盖这个场景——后台拉取完整内容时，Store的索引状态是忙碌的，不会提前触发检测。

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