如何在EWS Managed API中获取邮件的永久ID（移动/复制时不变）？

核心结论 #

• 无法手动设置ItemId：Exchange的ItemId是系统自动生成的唯一标识符，不支持手动指定，移动/复制操作必然会生成新的ItemId。
• AlternateID是可行方案：可以利用PermanentEntryId（AlternateID的一种类型）获取跨移动/复制操作保持不变的标识，满足追踪需求。

具体实现步骤 #

1. 获取邮件的PermanentEntryId
   在执行移动操作前，先通过EWS Managed API提取目标邮件的永久条目ID：

// item为待移动的EmailMessage实例
var permanentId = item.Id.GetAlternateId(IdFormat.PermanentEntryId, item.Id.Mailbox);
// 保存UniqueId值，用于后续查找移动后的邮件
string savedPermanentId = permanentId.UniqueId;

2. 移动后通过PermanentEntryId定位邮件
   邮件移动完成后，使用保存的永久ID转换为Exchange可识别的ItemId，从而找到Quarantine文件夹中的目标邮件：

// 构造AlternateId对象，指定永久ID格式
var alternateId = new AlternateId(IdFormat.PermanentEntryId, savedPermanentId, "目标邮箱地址");
// 转换为EWS标准ItemId格式
var convertedId = service.ConvertId(alternateId, IdFormat.EwsId);
// 绑定并获取移动后的邮件
EmailMessage movedItem = EmailMessage.Bind(service, new ItemId(convertedId.UniqueId));

关键注意事项 #

• PermanentEntryId特性：该ID在同一Exchange组织内，无论邮件被移动、复制到哪个文件夹，都不会发生变更，完全适配你的审核追踪需求。
• Exchange 2019兼容性：PermanentEntryId在Exchange 2019中完全支持，EWS Managed API对其有完整封装，无需额外配置。
• 禁止手动设置ItemId：Exchange系统不允许自定义ItemId，强行设置会引发操作失败或数据异常。

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