如何向已运行的WinForm应用实例传递命令行参数（已通过Mutex实现单实例锁）

哈哈，这个需求我做项目时也碰到过！既然已经用Mutex搞定了单实例检测，接下来要实现参数传递，用Windows系统的WM_COPYDATA消息是WinForm场景下最顺手的方案——它专门用于进程间传递数据，简单直接还靠谱。给你捋捋具体的实现步骤：

第一步：完善单实例检测逻辑，发送参数给已运行实例 #

在你的Program.cs里，当Mutex检测到已有实例运行时，我们需要找到那个实例的主窗口句柄，然后把命令行参数通过WM_COPYDATA发过去。直接上代码：

static class Program
{
    // 定义唯一窗口标识，用来精准定位已运行的主窗口
    private const string UniqueAppWindowTitle = "MySingleInstance_MainForm";
    // 全局唯一的Mutex名称，建议用GUID避免和其他应用冲突
    private const string UniqueMutexName = "Global\\{7F6A8D12-3B9E-4C5D-8A7E-1234567890AB}";

    [STAThread]
    static void Main(string[] args)
    {
        bool isNewInstance;
        using (Mutex mutex = new Mutex(true, UniqueMutexName, out isNewInstance))
        {
            if (isNewInstance)
            {
                // 首次启动，正常初始化应用
                Application.EnableVisualStyles();
                Application.SetCompatibleTextRenderingDefault(false);
                var mainForm = new MainForm();
                // 设置窗口标题为我们定义的唯一标识
                mainForm.Text = UniqueAppWindowTitle;
                Application.Run(mainForm);
            }
            else
            {
                // 找到已运行实例的窗口句柄
                IntPtr existingWindowHandle = FindWindow(null, UniqueAppWindowTitle);
                if (existingWindowHandle != IntPtr.Zero)
                {
                    // 把命令行参数拼接成字符串（复杂参数可以用JSON序列化）
                    string argsContent = string.Join("|", args);
                    // 准备传递的数据结构体
                    COPYDATASTRUCT dataStruct = new COPYDATASTRUCT
                    {
                        dwData = IntPtr.Zero,
                        cbData = argsContent.Length + 1, // 要包含字符串结束符
                        lpData = Marshal.StringToHGlobalUni(argsContent)
                    };

                    // 发送WM_COPYDATA消息
                    SendMessage(existingWindowHandle, WM_COPYDATA, IntPtr.Zero, ref dataStruct);

                    // 释放Marshal分配的内存，避免泄漏
                    Marshal.FreeHGlobal(dataStruct.lpData);

                    // 把已运行的窗口带到前台，提升用户体验
                    SetForegroundWindow(existingWindowHandle);
                }
            }
        }
    }

    // 导入需要的Windows API
    [DllImport("user32.dll", SetLastError = true)]
    private static extern IntPtr FindWindow(string lpClassName, string lpWindowName);

    [DllImport("user32.dll", CharSet = CharSet.Unicode)]
    private static extern IntPtr SendMessage(IntPtr hWnd, uint Msg, IntPtr wParam, ref COPYDATASTRUCT lParam);

    [DllImport("user32.dll")]
    private static extern bool SetForegroundWindow(IntPtr hWnd);

    // WM_COPYDATA消息的常量值
    private const uint WM_COPYDATA = 0x004A;

    // 用于传递数据的结构体
    [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
    private struct COPYDATASTRUCT
    {
        public IntPtr dwData;
        public int cbData;
        public IntPtr lpData;
    }
}

第二步：在主窗体中处理接收的参数 #

接下来在你的主窗体（比如MainForm）里，重写WndProc方法来监听WM_COPYDATA消息，解析并处理收到的参数：

public partial class MainForm : Form
{
    public MainForm()
    {
        InitializeComponent();
    }

    // 重写窗口消息处理方法
    protected override void WndProc(ref Message m)
    {
        const uint WM_COPYDATA = 0x004A;
        if (m.Msg == WM_COPYDATA)
        {
            // 解析传递过来的数据结构体
            COPYDATASTRUCT receivedData = (COPYDATASTRUCT)Marshal.PtrToStructure(m.LParam, typeof(COPYDATASTRUCT));
            string argsString = Marshal.PtrToStringUni(receivedData.lpData);
            
            if (!string.IsNullOrEmpty(argsString))
            {
                // 拆分参数（这里用|分隔，你可以换成其他不会和参数冲突的分隔符）
                string[] receivedArgs = argsString.Split('|');
                // 这里写你的参数处理逻辑，比如弹出提示、加载指定文件等
                MessageBox.Show($"已收到新参数：{string.Join(", ", receivedArgs)}");
                // 示例：如果第一个参数是文件路径，就打开这个文件
                // if (receivedArgs.Length > 0) OpenTargetFile(receivedArgs[0]);
            }

            // 告诉发送方消息已处理成功
            m.Result = (IntPtr)1;
            return;
        }
        // 其他消息交给基类处理
        base.WndProc(ref m);
    }

    // 同样需要定义COPYDATASTRUCT结构体
    [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
    private struct COPYDATASTRUCT
    {
        public IntPtr dwData;
        public int cbData;
        public IntPtr lpData;
    }
}

几个关键注意点 #

• 唯一性保障：Mutex名称和窗口标识一定要全局唯一，建议用GUID命名Mutex；如果担心窗口标题被修改，也可以用SetClassLongPtr设置窗口类名来定位。
• 复杂参数处理：如果要传递复杂对象（比如自定义配置），可以先序列化成JSON字符串再传递，接收后反序列化即可。
• 内存泄漏：用Marshal.StringToHGlobalUni分配的内存一定要用Marshal.FreeHGlobal释放，避免内存泄漏。
• 多用户场景：如果应用需要支持多用户登录环境，Mutex名称要加Global\\前缀，这样跨用户会话也能检测到已运行实例。

备注：内容来源于stack exchange，提问作者Manali