如何通过自定义Asynchronous Pluggable Protocols实现Windows应用单实例持续传值

我之前用Asynchronous Pluggable Protocols（APP）做内网Web到Windows应用的通信时，也踩过每次点击协议链接都启动新实例的坑，折腾了好一阵才搞定。下面是我亲测有效的解决方案，核心思路是让应用本身支持单实例运行+进程间通信（IPC）传递数据：

第一步：给Windows应用加单实例检测逻辑 #

这是基础，你需要在应用启动时判断是否已有实例在运行：

• 用**命名互斥量（Mutex）**是最可靠的方式。在应用入口处创建一个全局唯一的互斥量，比如：

  HANDLE hMutex = CreateMutex(NULL, TRUE, L"Global\\YourAppUniqueMutexName");
  if (GetLastError() == ERROR_ALREADY_EXISTS) {
      // 已有实例在运行，接下来要把数据传给它
      CloseHandle(hMutex);
      SendDataToExistingInstance(GetCommandLineW());
      ExitProcess(0); // 直接退出新实例
  }
  

  注意互斥量名称要足够唯一，最好带上你的公司/产品标识，避免和其他应用冲突。如果是UAC环境，还要注意权限设置，必要时用CreateMutexEx配置正确的访问权限，防止高权限和低权限进程之间的互斥失效。

第二步：用IPC把数据传递给已有实例 #

当新实例检测到已有运行实例时，需要把APP协议传递过来的URL数据发送给它，常用的IPC方式有两种：

方式1：WM_COPYDATA（适合简单数据场景） #

这是Win32原生的消息传递机制，实现简单，适合传递字符串或小体积数据：

1. 新实例需要找到已有实例的主窗口句柄，可以通过EnumWindows枚举窗口+检查窗口所属进程ID的方式获取。
2. 构造COPYDATASTRUCT结构体，把URL数据塞进去，然后发送WM_COPYDATA消息：

   COPYDATASTRUCT cds;
   cds.dwData = 0; // 自定义标识，用来区分不同类型的消息
   cds.cbData = (lstrlenW(szUrl) + 1) * sizeof(WCHAR);
   cds.lpData = szUrl;
   SendMessage(hExistingMainWnd, WM_COPYDATA, (WPARAM)NULL, (LPARAM)&cds);
   

3. 已有实例的窗口过程中处理WM_COPYDATA消息，提取数据并做业务处理：

   case WM_COPYDATA:
       COPYDATASTRUCT* pCds = (COPYDATASTRUCT*)lParam;
       wchar_t* szReceivedUrl = (wchar_t*)pCds->lpData;
       // 这里写你处理URL数据的业务逻辑
       return TRUE;
   

方式2：命名管道（适合复杂/双向通信场景） #

如果以后需要更复杂的交互（比如应用给Web端返回处理结果），命名管道是更灵活的选择：

1. 已有实例启动时创建一个命名管道服务器，监听连接请求。
2. 新实例检测到已有实例后，创建管道客户端，连接到服务器并发送URL数据。
3. 服务器端接收数据后完成业务处理，按需返回结果，最后关闭连接。

第三步：在APP协议处理逻辑中配合单实例流程 #

你的IInternetProtocol实现（比如Start方法）里，不要直接调用CreateProcess启动应用，而是先检查互斥量是否存在：

• 如果互斥量不存在，正常启动应用并传递URL参数；
• 如果互斥量已存在，直接调用上面的SendDataToExistingInstance方法传递数据，不需要启动新进程。

这样就能保证每次点击协议链接时，要么启动应用（第一次点击），要么把数据传给已运行的实例，不会重复启动新进程。

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