为何VSTO与Office JS Outlook插件的conversationId不一致？如何统一？

一、不一致的原因 #

• 编码/格式差异：Office JS返回的是Base64编码的EWS（Exchange Web Services）会话ID，而VSTO通过MailItem.ConversationID获取的是十六进制格式的MAPI（Messaging Application Programming Interface）会话ID。二者是同一底层会话标识的不同表示形式，并非不同的ID值。
• API体系适配：两种格式分别适配不同的插件体系——Web插件（Office JS）依赖EWS协议，使用Base64编码的ID；桌面COM插件（VSTO）基于MAPI接口，返回十六进制格式的ID。

二、在VSTO中获取与Office JS一致的ConversationID #

只需将VSTO获取到的十六进制MAPI ID转换为EWS的Base64格式，即可得到和Office JS相同的会话ID。具体实现如下：

1. 格式转换函数 #

// 将MAPI十六进制会话ID转换为EWS Base64格式（与Office JS返回值一致）
private string ConvertMapiConversationIdToEwsFormat(string mapiHexConversationId)
{
    // 十六进制字符串转字节数组
    byte[] mapiBytes = new byte[mapiHexConversationId.Length / 2];
    for (int i = 0; i < mapiBytes.Length; i++)
    {
        mapiBytes[i] = Convert.ToByte(mapiHexConversationId.Substring(i * 2, 2), 16);
    }

    // EWS会话ID需按固定结构封装：前缀字节 + MAPI字节数组 + 后缀字节
    List<byte> ewsBytes = new List<byte>();
    ewsBytes.AddRange(new byte[] { 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 });
    ewsBytes.AddRange(mapiBytes);
    ewsBytes.AddRange(new byte[] { 0x00, 0x00, 0x00, 0x00 });

    // 转换为Base64字符串
    return Convert.ToBase64String(ewsBytes);
}

2. 修改原获取逻辑 #

在你现有的GetSelectedEmailConversationId方法中，替换会话ID的获取代码：

// 原代码：conversationId = mailItem.ConversationID;
// 修改为：
conversationId = ConvertMapiConversationIdToEwsFormat(mailItem.ConversationID);

修改后，VSTO返回的会话ID将与Office JS获取的完全一致。

内容的提问来源于stack exchange，提问作者M Јǚйáĩď