应统一使用CoInitializeEx而非CoInitialize，确保每线程仅初始化一次且模式匹配：GUI线程用COINIT_APARTMENTTHREADED，纯后台用COINIT_MULTITHREADED；子线程须自行初始化并配对调用CoUninitialize。
CoInitializeEx 失败返回 RPC_E_CHANGED_MODE 怎么办
这个错误说明当前线程的 COM 套间（apartment）模式已经由其他代码设定了，而你又试图用不同模式再次初始化。COM 不允许同一线程多次以冲突模式调用 CoInitializeEx。
常见于第三方库（比如某些 GUI 框架、音视频 SDK）静默调用了 CoInitialize 或 CoInitializeEx(COINIT_APARTMENTTHREADED)，而你的代码随后又传入 COINIT_MULTITHREADED —— 模式不兼容直接报错。
- 先检查是否重复调用：确保每个线程最多只调用一次
CoInitializeEx，且与后续CoUninitialize成对 - 统一使用
COINIT_APARTMENTTHREADED：GUI 线程、大多数 Windows API（如剪贴板、WIC、Media Foundation）都要求单线程套间（STA），优先选它 - 若必须用 MTA（多线程套间），确认线程不调用任何 STA 依赖的 COM 组件，且所有 COM 对象创建都显式指定
CLSCTX_INPROC_SERVER | CLSCTX_DISABLE_AGGREGATION等安全上下文 - 调试时可加一句
if (FAILED(hr)) { OutputDebugString(L"CoInitializeEx failed: "); ... }快速定位哪次调用撞车
主线程初始化后子线程怎么安全用 COM
COM 套间是线程绑定的，主线程初始化了不代表子线程能直接用。子线程必须自己调用 CoInitializeEx，否则调用 CoCreateInstance 会崩或返回 RPC_E_NOTINITIALIZED。
尤其要注意：Windows 线程池回调、std::thread、Qt 的 QThread、甚至某些异步回调（如 WinRT 的 resume_background）都运行在全新线程上，它们没有继承主线程的 COM 状态。
- 子线程入口函数第一件事就是调用
CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED)（GUI 相关）或COINIT_MULTITHREADED（纯后台计算） - 线程退出前必须配对调用
CoUninitialize()，漏掉会导致资源泄漏，严重时影响进程内其他线程的 COM 调用 - 避免跨线程传递原始 COM 接口指针（如
IUnknown*）—— 它们不是线程安全的。要用CoMarshalInterThreadInterfaceInStream+CoGetInterfaceAndReleaseStream封装，或改用 Windows Runtime 的ABI::Windows::Foundation::IAsyncAction等线程感知类型
CoInitialize 和 CoInitializeEx 该选哪个
CoInitialize 是旧接口，等价于 CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED)，但它无法指定 MTA，也不返回明确错误码（只靠返回值是否为 S_OK 判断），已不推荐新代码使用。
所有新项目应无条件用 CoInitializeEx，理由很实在：
- 能明确区分 STA/MTA 场景，避免隐式行为引发的兼容问题
- 返回标准 HRESULT，可直接用
FAILED(hr)判断，比CoInitialize的 void 返回更可控 - Windows 10+ 对某些组件（如 InkPresenter、Win2D）强制要求显式指定套间模式，
CoInitialize会静默失败 - 如果项目要支持 DLL 插件或嵌入脚本引擎（如 ChakraCore），插件可能自行调用初始化，
CoInitializeEx的错误码能帮你快速识别冲突点
初始化成功后为什么 CoCreateInstance 还失败
CoInitializeEx 成功只代表 COM 子系统就绪，不代表具体组件可用。常见真凶是注册表缺失、DLL 未加载、权限不足或对象本身不支持所请求的接口。
典型错误码和对应动作：
-
REGDB_E_CLASSNOTREG：CLSID 未注册，检查是否漏了regsvr32或项目没启用“注册 COM 组件”属性（VS 中右键项目 → 属性 → 配置属性 → 常规 → “注册输出”设为 True） -
CLASS_E_NOAGGREGATION：尝试聚合一个不支持聚合的对象，把ppv参数传给CoCreateInstance前确保为nullptr，或改用CoCreateInstanceEx显式控制聚合行为 -
E_ACCESSDENIED：UWP 应用或沙盒环境里调用传统 COM 组件（如 WIA、DirectShow），需在 manifest 中声明runFullTrust或改用 Windows Runtime 替代方案 - 返回
S_OK但*ppv为nullptr：检查riid是否填错（比如误传__uuidof(IDispatch)却期望得到IStorage）
COM 初始化本身只是个门槛，后面每一步（注册、激活、接口查询）都可能卡住。别只盯着 CoInitializeEx 的返回值看。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
