如何通过C#为Outlook邮件设置Azure信息保护标签及权限校验

我来帮你搞定这两个问题，结合你的实际场景给出可落地的代码和步骤：

问题1：如何在C#中为Outlook邮件设置Azure信息保护标签？ #

要给Outlook邮件设置AIP标签，核心是通过Outlook对象模型操作对应的MAPI属性。下面是具体步骤：

1. 准备依赖 #

首先在你的项目里引用Microsoft.Office.Interop.Outlook——你可以通过NuGet安装这个包，或者在Visual Studio的COM引用里找到「Microsoft Outlook xx.x Object Library」添加进来。

2. 获取邮件对象 #

不管是新建邮件还是处理已有的邮件，都要先拿到MailItem对象。比如创建新邮件：

using Outlook = Microsoft.Office.Interop.Outlook;

// 初始化Outlook应用实例
var outlookApp = new Outlook.Application();
var mailItem = (Outlook.MailItem)outlookApp.CreateItem(Outlook.OlItemType.olMailItem);

3. 设置AIP标签 #

AIP标签在Outlook里对应两个关键的MAPI属性：标签ID（0x0019001F）和标签名称（0x001A001F）。你需要先从Azure门户的信息保护面板里拿到目标标签的GUID格式的标签ID，然后用它来设置：

// 替换成你在Azure门户里拿到的标签ID
var aipLabelId = "your-confidential-label-guid";
// 设置标签ID属性
mailItem.PropertyAccessor.SetProperty("http://schemas.microsoft.com/mapi/proptag/0x0019001F", aipLabelId);
// 可选：设置标签名称，部分场景下需要显式指定
mailItem.PropertyAccessor.SetProperty("http://schemas.microsoft.com/mapi/proptag/0x001A001F", "Confidential");

// 保存设置
mailItem.Save();

如果想通过标签名称自动查找ID，可以遍历Outlook的分类集合（AIP标签会同步为Outlook分类）：

var categories = outlookApp.Session.Categories;
foreach (Outlook.Category category in categories)
{
    if (category.Name.Equals("Confidential", System.StringComparison.OrdinalIgnoreCase))
    {
        var labelId = category.PropertyAccessor.GetProperty("http://schemas.microsoft.com/mapi/proptag/0x0019001F").ToString();
        // 用找到的ID设置邮件标签
        mailItem.PropertyAccessor.SetProperty("http://schemas.microsoft.com/mapi/proptag/0x0019001F", labelId);
        break;
    }
}

问题2：校验收件人权限并自动设置对应AIP标签 #

针对你的场景——检查邮件是否已设置AIP标签，未设置则根据收件人权限选择「Confidential」或「Confidential View only」，下面是完整的实现逻辑：

核心思路 #

1. 检查当前邮件是否已经有AIP标签
2. 解析所有收件人（To/Cc/Bcc），判断他们的权限（比如是否属于内部域、特定安全组）
3. 根据权限结果选择对应标签并设置

完整代码示例 #

using Outlook = Microsoft.Office.Interop.Outlook;
using System.Linq;

public void AutoApplyAIPLabelBasedOnRecipients(Outlook.MailItem mailItem)
{
    if (mailItem == null) return;

    // 第一步：检查邮件是否已有AIP标签
    bool hasExistingLabel = false;
    try
    {
        var existingLabelId = mailItem.PropertyAccessor.GetProperty("http://schemas.microsoft.com/mapi/proptag/0x0019001F").ToString();
        hasExistingLabel = !string.IsNullOrEmpty(existingLabelId);
    }
    catch
    {
        // 没有设置标签时会抛出异常，直接忽略即可
    }

    if (hasExistingLabel) return;

    // 第二步：校验收件人权限（这里示例判断是否全为内部域用户，你可以替换成自己的权限逻辑）
    bool allInternal = AreAllRecipientsInternal(mailItem, "your-company-domain.com");

    // 第三步：选择对应标签并设置
    string targetLabelId;
    string targetLabelName;

    if (allInternal)
    {
        // 内部收件人用「Confidential」标签
        targetLabelId = "your-confidential-label-guid";
        targetLabelName = "Confidential";
    }
    else
    {
        // 包含外部收件人用「Confidential View only」标签
        targetLabelId = "your-confidential-viewonly-label-guid";
        targetLabelName = "Confidential View only";
    }

    // 应用标签
    mailItem.PropertyAccessor.SetProperty("http://schemas.microsoft.com/mapi/proptag/0x0019001F", targetLabelId);
    mailItem.PropertyAccessor.SetProperty("http://schemas.microsoft.com/mapi/proptag/0x001A001F", targetLabelName);

    // 保存更改
    mailItem.Save();
}

// 辅助方法：检查所有收件人是否属于指定内部域
private bool AreAllRecipientsInternal(Outlook.MailItem mailItem, string internalDomain)
{
    var allRecipients = mailItem.Recipients.Cast<Outlook.Recipient>();

    foreach (var recipient in allRecipients)
    {
        string email = recipient.Address;

        // 如果是Exchange内部用户，需要获取其SMTP地址
        if (recipient.AddressEntry != null && recipient.AddressEntry.Type == "EX")
        {
            var exUser = recipient.AddressEntry.GetExchangeUser();
            if (exUser != null)
            {
                email = exUser.PrimarySmtpAddress;
            }
        }

        // 检查域名是否匹配内部域
        if (!email.EndsWith($"@{internalDomain}", System.StringComparison.OrdinalIgnoreCase))
        {
            return false;
        }
    }

    return true;
}

额外注意事项 #

• 如果是开发Outlook插件，建议在ItemSend事件中调用这个方法，实现发送前自动校验并设置标签
• 务必用Azure门户里的标签ID，不要硬编码标签名称——名称可能会被修改，ID是唯一不变的
• 运行程序的用户需要在Azure AD中拥有对应的AIP权限，否则无法设置标签

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