COM调用前必须CoInitializeEx初始化，多线程用COINIT_MULTITHREADED；对象需AddRef/Release管理，QueryInterface失败多因IID不匹配或组件未注册；BSTR须SysAllocString分配，推荐_bstr_t；IDispatch调用注意DISPID大小写、VARIANT初始化及rgvarg逆序填充。
COM接口调用前必须完成CoInitializeEx和对象创建
不初始化COM，CoCreateInstance会直接返回RPC_E_CHANGED_MODE或CO_E_NOTINITIALIZED。多线程场景下必须用COINIT_MULTITHREADED（而非过时的COINIT_APARTMENTTHREADED），否则后续接口调用可能随机崩溃或挂起。
常见错误是只在主线程调用CoInitialize，但实际使用COM对象的线程没初始化；或者初始化后忘了匹配调用CoUninitialize，导致资源泄漏。
- 单线程STA模式：仅限极少数旧组件（如部分Shell接口），需配
COINIT_APARTMENTTHREADED - 推荐MTA模式：所有新开发或通用组件（如
IMMDeviceEnumerator、IShellWindows）都应走COINIT_MULTITHREADED - COM对象生命周期必须由调用方管理：
AddRef/Release不能省，智能指针如CComPtr可减少出错
QueryInterface失败通常因IID不匹配或组件未注册
拿到IUnknown*后调用QueryInterface返回E_NOINTERFACE，不是代码写错了，大概率是目标接口根本不存在于该COM对象——比如对IClassFactory查IShellBrowser肯定失败。
更隐蔽的问题是注册表里缺失CLSID或InprocServer32路径，尤其在64位系统跑32位程序时，容易误查到HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node下的错误键值。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 确认接口定义：从SDK头文件（如
mmdeviceapi.h）里复制准确的__uuidof(IMMDeviceEnumerator)，别手敲IID - 检查进程位数匹配：32位exe只能加载32位COM服务器，64位同理；混合调用必须用代理/存根或进程外激活
- 调试技巧：用
oleview.exe查看目标CLSID是否注册、支持哪些接口
字符串参数传入COM接口要转成BSTR且注意内存归属
Windows COM接口大量使用BSTR（如IShellLink::SetPath），直接传std::string.c_str()或L"xxx"会导致访问违规——BSTR有独立内存布局，必须用SysAllocString分配，且COM方法内部不会帮你释放。
典型坑是反复调用SysAllocString却没配对SysFreeString，造成内存泄漏；或者把栈上临时wchar_t[]强转为BSTR，函数返回后指针就野了。
- 安全做法：用
_bstr_t包装，构造时自动SysAllocString，析构自动SysFreeString - 避免裸
BSTR：除非明确需要控制生命周期（如跨函数传递且不希望自动释放） - 注意宽字符编码：Windows API默认UTF-16LE，
std::u8string或UTF-8字面量需先转换
IDispatch调用方法得靠DISPID和VARIANT参数栈
遇到只有类型库（.tlb）没C++头文件的COM组件（比如某些脚本宿主或Office插件），就得走IDispatch动态调用。这时候GetIDsOfNames查不到DISPID，往往是因为名字大小写不一致（COM接口名区分大小写）或没正确加载类型库。
DISPPARAMS结构体看着简单，但rgvarg参数数组必须逆序压栈（最后一个参数在rgvarg[0]），且每个VARIANT字段都要手动VariantInit再设vt和值，漏一步就会触发DISP_E_TYPEMISMATCH或ACCESS_VIOLATION。
- 优先用
#import生成智能指针：VS自动生成的.tlh文件能绕过手工IDispatch的全部陷阱 - 调试
DISPID：用OleView.exe打开.tlb，看接口方法右侧显示的真实DISPID数值 - 参数顺序陷阱：C++调用约定是右→左压栈，但
DISPPARAMS要求左→右填rgvarg，所以代码里要倒着循环赋值
COM本质是二进制契约，不是语言特性。接口定义、内存模型、线程模型三者只要有一处对不上，运行时就崩，而且错误位置往往远离问题根源。动手前务必确认目标组件的文档明确写了支持哪类调用方式，别指望“试试看”。
