如何通过VSTO插件获取正确句柄，调用SetWindowDisplayAffinity实现邮件窗口黑屏

核心问题解析 #

之前通过进程获取句柄失效，本质是Outlook的邮件窗口属于独立的Inspector实例，而非主进程窗口。盲目遍历进程窗口无法精准定位目标邮件窗口，必须通过Outlook对象模型直接获取对应窗口句柄。

具体实现方案 #

1. 导入Win32 API声明 #

先在代码中引入需要的系统API：

using System.Runtime.InteropServices;

public static class Win32Native
{
    public const uint WDA_EXCLUDED_FROM_CAPTURE = 0x00000011; // 对应黑屏防捕获效果

    [DllImport("user32.dll")]
    public static extern bool SetWindowDisplayAffinity(IntPtr hWnd, uint dwAffinity);
}

2. 获取当前激活的邮件窗口句柄 #

利用Outlook对象模型直接定位激活的Inspector窗口，获取其句柄：

using Outlook = Microsoft.Office.Interop.Outlook;

public void EnableBlackoutForActiveMail()
{
    Outlook.Inspector activeInspector = Globals.ThisAddIn.Application.ActiveInspector();
    if (activeInspector != null && activeInspector.CurrentItem is Outlook.MailItem)
    {
        // 直接从Inspector对象获取窗口句柄
        IntPtr mailWindowHandle = new IntPtr(activeInspector.HWND);
        
        // 调用API设置黑屏效果
        bool success = Win32Native.SetWindowDisplayAffinity(mailWindowHandle, Win32Native.WDA_EXCLUDED_FROM_CAPTURE);
        
        // 可选：处理调用失败场景
        if (!success)
        {
            int errorCode = Marshal.GetLastWin32Error();
            // 这里可添加日志记录或错误提示逻辑
        }
    }
}

3. 批量处理所有已打开的邮件窗口 #

如果需要对所有打开的邮件窗口生效，遍历Inspectors集合即可：

public void EnableBlackoutForAllMails()
{
    foreach (Outlook.Inspector inspector in Globals.ThisAddIn.Application.Inspectors)
    {
        if (inspector.CurrentItem is Outlook.MailItem)
        {
            IntPtr windowHandle = new IntPtr(inspector.HWND);
            Win32Native.SetWindowDisplayAffinity(windowHandle, Win32Native.WDA_EXCLUDED_FROM_CAPTURE);
        }
    }
}

关键注意事项 #

• 拒绝进程遍历：Outlook的多窗口架构下，每个邮件窗口对应独立的Inspector实例，通过对象模型获取句柄是唯一可靠的方式。
• 类型校验：必须判断Inspector.CurrentItem是MailItem，避免误处理日历、任务等其他类型的窗口。
• 权限验证：VSTO插件默认拥有调用Win32 API的权限，若在严格管控的域环境中运行，需确认插件的信任级别。

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