调整最小化进程窗口状态：C#单实例应用置前台失效问题求解

核心错误原因 #

• ShowWindow 方法传入了错误的句柄参数：你当前代码传入的是进程句柄bProcess.Handle，实际应该传入主窗体句柄bProcess.MainWindowHandle，这是最小化场景下恢复失效的最核心原因
• 缺少空值校验，当获取目标进程失败时直接访问成员会触发空引用异常
• 未适配Windows系统前台窗口权限限制，部分场景下SetForegroundWindow调用会被系统拦截

完整修正代码 #

首先补充正确的Win32 API声明：

// 放在Program类内部作为Native方法声明
[DllImport("user32.dll")]
private static extern bool ShowWindow(IntPtr hWnd, int nCmdShow);
[DllImport("user32.dll")]
private static extern bool SetForegroundWindow(IntPtr hWnd);
[DllImport("user32.dll")]
private static extern bool IsIconic(IntPtr hWnd);
[DllImport("user32.dll")]
private static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint lpdwProcessId);
[DllImport("user32.dll")]
private static extern bool AttachThreadInput(uint idAttach, uint idAttachTo, bool fAttach);
[DllImport("user32.dll")]
static extern IntPtr GetForegroundWindow();
[DllImport("kernel32.dll")]
static extern uint GetCurrentThreadId();

private const int SW_RESTORE = 9;
// 替换为你自己应用的唯一标识，避免和其他程序重名
private static Mutex mutex = new Mutex(true, "你的应用唯一标识，比如{8F4F2D6B-ABCD-4321-1234-1234567890AB}");

然后修正Main方法逻辑：

static void Main()
{
    if (mutex.WaitOne(TimeSpan.Zero, true))
    {
        try
        {
            Application.EnableVisualStyles();
            Application.SetCompatibleTextRenderingDefault(false);
            Application.Run(new Form1());
        }
        finally
        {
            mutex.ReleaseMutex();
        }
    }
    else
    {
        Process current = Process.GetCurrentProcess();
        // 排除当前新启动的进程，拿到已运行的旧实例
        Process bProcess = Process.GetProcessesByName(current.ProcessName).FirstOrDefault(p => p.Id != current.Id);
        if (bProcess != null && bProcess.MainWindowHandle != IntPtr.Zero)
        {
            IntPtr hwnd = bProcess.MainWindowHandle;
            // 兼容系统前台窗口权限限制
            uint foreThread = GetWindowThreadProcessId(GetForegroundWindow(), out _);
            uint appThread = GetCurrentThreadId();
            if (foreThread != appThread)
            {
                AttachThreadInput(foreThread, appThread, true);
            }

            // 判断窗口是否处于最小化状态，是则先恢复
            if (IsIconic(hwnd))
            {
                ShowWindow(hwnd, SW_RESTORE);
            }
            // 置为前台
            SetForegroundWindow(hwnd);

            if (foreThread != appThread)
            {
                AttachThreadInput(foreThread, appThread, false);
            }
        }
    }
}

额外注意事项 #

• 如果你的应用存在主窗体句柄动态变更、多窗体等场景，建议改用Windows消息通知的方式让已运行实例自己处理唤起逻辑，稳定性更高
• 特殊权限场景下如果仍有置前失败问题，可以补充调用BringWindowToTop、SetWindowPos方法作为兜底

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