基于.NET实现MAPI服务提供程序及简易默认邮件客户端的可行性问询

先给你吃个定心丸：完全可以用.NET实现你的需求！不用依赖Outlook、Thunderbird这类复杂客户端，我们可以打造一个轻量的Mapi32.dll存根，让系统把它识别为默认邮件客户端，最终通过Exchange Web Service（EWS）完成邮件提交。下面是具体的实现思路和关键步骤：

1. 核心原理：让.NET代码导出MAPI所需的非托管函数 #

MAPI客户端要求你的DLL导出特定的标准函数（比如MAPISendMail、MAPIInitialize），而.NET本身是托管代码，不过我们可以借助DllExport工具（比如UnmanagedExports NuGet包），直接从C#代码中导出符合MAPI规范的非托管函数，这样Windows就能把你的DLL当作合法的MAPI客户端来调用。

2. 分步实现指南 #

第一步：搭建.NET项目并配置导出工具 #

• 创建一个**Class Library (.NET Framework)**项目（优先选.NET Framework，和非托管互操作的兼容性更好）
• 安装UnmanagedExports NuGet包——它是实现托管方法转非托管导出的核心工具
• 在项目属性里，设置好目标平台（x86/x64，要和调用你的程序匹配，不然会加载失败）

第二步：实现MAPI核心导出函数 #

你不用实现所有MAPI函数，只需要搞定几个关键入口就行，其中MAPISendMail是其他程序调用MAPI发邮件的核心入口：

using System;
using RGiesecke.DllExport;
using System.Runtime.InteropServices;

public class MapiStub
{
    // 导出MAPISendMail函数，匹配MAPI的调用约定
    [DllExport("MAPISendMail", CallingConvention = CallingConvention.StdCall)]
    public static int MAPISendMail(IntPtr session, IntPtr hwnd, 
        [MarshalAs(UnmanagedType.LPStruct)] MapiMessage message, 
        int flags, int reserved)
    {
        try
        {
            // 提取MAPI传入的邮件信息：主题、正文、收件人等
            string subject = message.lpszSubject ?? "无主题";
            string body = message.lpszNoteText ?? string.Empty;
            
            // 调用EWS发送邮件的逻辑
            SendEmailViaEws(subject, body, message.lpRecips, message.nRecipCount);
            
            // 返回MAPI_SUCCESS表示发送成功
            return 0;
        }
        catch (Exception ex)
        {
            // 出错时返回对应的MAPI错误码，比如MAPI_E_FAILURE
            return 0x80000000;
        }
    }

    // 必需的初始化函数，简单返回成功即可
    [DllExport("MAPIInitialize", CallingConvention = CallingConvention.StdCall)]
    public static int MAPIInitialize(IntPtr lpMapiInit)
    {
        return 0;
    }

    // 必需的清理函数，空实现即可
    [DllExport("MAPIUninitialize", CallingConvention = CallingConvention.StdCall)]
    public static void MAPIUninitialize()
    {
        // 这里可以加你需要的清理逻辑
    }
}

// 定义和非托管MAPI匹配的消息结构体
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi)]
public class MapiMessage
{
    public int ulReserved;
    public string lpszSubject;
    public string lpszNoteText;
    public string lpszMessageType;
    public string lpszDateReceived;
    public string lpszConversationID;
    public int flFlags;
    public IntPtr lpOriginator;
    public int nRecipCount;
    public IntPtr lpRecips;
    public int nFileCount;
    public IntPtr lpFiles;
}

// MAPI收件人结构体定义
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi)]
public class MapiRecipDesc
{
    public int ulReserved;
    public int ulRecipClass;
    public string lpszName;
    public string lpszAddress;
    public int ulEIDSize;
    public IntPtr lpEntryID;
}

第三步：实现EWS邮件发送逻辑 #

接下来编写SendEmailViaEws方法，用EWS Managed API连接Exchange服务器发送邮件：

using Microsoft.Exchange.WebServices.Data;
using System.Collections.Generic;

private static void SendEmailViaEws(string subject, string body, IntPtr recipsPtr, int recipCount)
{
    // 1. 解析MAPI传入的收件人列表
    List<string> recipients = new List<string>();
    if (recipCount > 0 && recipsPtr != IntPtr.Zero)
    {
        int size = Marshal.SizeOf(typeof(MapiRecipDesc));
        for (int i = 0; i < recipCount; i++)
        {
            IntPtr recipPtr = IntPtr.Add(recipsPtr, i * size);
            MapiRecipDesc recip = (MapiRecipDesc)Marshal.PtrToStructure(recipPtr, typeof(MapiRecipDesc));
            // 提取收件人邮箱地址，这里根据实际情况处理格式
            recipients.Add(recip.lpszAddress);
        }
    }

    // 2. 配置EWS连接
    ExchangeService service = new ExchangeService(ExchangeVersion.Exchange2016);
    // 这里可以换成你的Exchange账户凭据，或者考虑用Windows身份验证
    service.Credentials = new WebCredentials("your-exchange-username", "your-exchange-password");
    service.Url = new Uri("https://your-exchange-server-url/EWS/Exchange.asmx");

    // 3. 创建并发送邮件
    EmailMessage email = new EmailMessage(service);
    email.Subject = subject;
    email.Body = new MessageBody(BodyType.Text, body);
    
    foreach (string addr in recipients)
    {
        email.ToRecipients.Add(addr);
    }

    email.Send();
}

提示：记得安装Microsoft.Exchange.WebServices NuGet包来使用EWS Managed API。

第四步：注册为系统默认邮件客户端 #

最后需要修改系统注册表，让Windows识别你的DLL为默认MAPI客户端：

• 在HKEY_LOCAL_MACHINE\SOFTWARE\Clients\Mail下创建你的应用名称项（比如MyLightweightMailClient）
• 在该项下创建DefaultIcon和shell\open\command子项，指定你的DLL路径和显示名称
• 将HKEY_LOCAL_MACHINE\SOFTWARE\Clients\Mail的默认值设置为你的应用名称
• 具体的注册表项格式可以参考微软的MAPI客户端注册规范，确保系统能正确调用你的DLL

3. 关键注意事项 #

• 平台一致性：一定要保证你的DLL编译平台（x86/x64）和调用它的程序一致，否则会出现加载失败的问题
• 错误处理：在MAPISendMail里要捕获异常，返回标准的MAPI错误码，这样调用你的程序才能正确判断发送状态
• EWS权限：确保你的Exchange账户有通过EWS发送邮件的权限，并且服务器的EWS服务已启用
• 最小化实现：不用实现所有MAPI函数，只需要MAPIInitialize、MAPISendMail、MAPIUninitialize这三个核心函数就能满足基本需求

内容的提问来源于stack exchange，提问作者Jan Vojtěch Vaníček