自定义UploadOperationHandler访问IUploadMailData时缺失邮件头字段（harmon.ie Outlook插件）

嘿，我在做harmon.ie Outlook插件开发时也碰到过类似的问题，咱们来拆解一下你的操作和解决方案：

首先，你当前操作的潜在问题 #

你通过IUploadMailItemData.MetaDataValue结合Harmonie.SDK.MailHeader常量获取邮件头，这个思路本身没问题，但默认情况下harmon.ie只会预加载Received、Date、From这类高频使用的邮件头字段，像To、Cc这类字段并没有被自动加载到MetaDataValue里，所以你直接访问是拿不到的。

另外还有个容易混淆的点：邮件的To收件人信息其实更常存在于Outlook邮件对象的直接属性中，而非原始邮件头字段里，直接访问原生对象会更可靠。

解决方案：两种方式获取To字段 #

方式1：直接访问原生Outlook MailItem对象

harmon.ie的IUploadMailItemData会暴露底层的Outlook邮件对象，你可以直接读取它的To属性，甚至获取完整的收件人集合：

foreach (var uploadItem in uploadItems)
{
    if (uploadItem is IUploadMailItemData mailItemData)
    {
        // 取出原生Outlook MailItem实例
        var outlookMail = mailItemData.Item as Outlook.MailItem;
        if (outlookMail != null)
        {
            // 直接获取To字段的字符串形式
            string toRecipients = outlookMail.To;
            
            // 如果需要更精细的收件人信息（比如邮箱地址、显示名），遍历Recipients集合
            foreach (Outlook.Recipient recip in outlookMail.Recipients)
            {
                if (recip.Type == (int)Outlook.OlMailRecipientType.olTo)
                {
                    string displayName = recip.Name;
                    string emailAddress = recip.Address;
                    // 这里可以做你需要的重命名逻辑
                }
            }
        }
    }
}

方式2：主动加载原始邮件头的To字段（如果确实需要原始头格式）

如果你一定要从原始邮件头中获取To字段，需要借助Outlook的PropertyAccessor读取对应的MAPI属性，To字段对应的MAPI属性标签是0x0E04001F：

if (outlookMail != null)
{
    Outlook.PropertyAccessor propAccessor = outlookMail.PropertyAccessor;
    // 读取原始邮件头中的To字段值
    string rawToHeader = propAccessor.GetProperty("http://schemas.microsoft.com/mapi/proptag/0x0E04001F") as string;
}

额外注意点 #

• 确保你的插件拥有足够的权限访问Outlook的邮件属性，部分企业环境下的权限限制可能会影响属性读取。
• 如果你频繁需要访问这类未预加载的字段，可以查看harmon.ie SDK文档，确认是否有初始化配置项可以指定预加载额外的邮件头字段，减少后续的属性读取开销。

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