如何用现代C++/WinRT调用Office自动化COM API并转换接口？

要把获取到的com_ptr<IUnknown>转换成对应的Office强类型接口，核心是利用COM的QueryInterface机制，现代C的com_ptr（不管是微软WIL库的还是C/WinRT自带的）都封装了更简洁的as方法来完成这件事，同时结合智能指针特性避免手动管理COM对象生命周期。

完整实现步骤 #

1. 初始化COM环境
   Office自动化必须在单线程单元(STA)中运行，所以第一步要初始化COM：

// 使用WIL库的com_ptr
#include <wil/com.h>
#include <windows.h>

int main()
{
    // 初始化STA线程模型的COM环境
    check_hresult(CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED));
    // 用scope_exit自动清理COM环境
    auto comCleanup = wil::scope_exit([] { CoUninitialize(); });

    // 后续代码...
}

如果用C++/WinRT的com_ptr，可以更简洁：

#include <winrt/base.h>
#include <windows.h>

int main()
{
    winrt::init_apartment(); // 自动初始化STA环境

    // 后续代码...
}

2. 获取Active对象并转换接口
   你已经拿到了IUnknown指针，接下来用as方法直接转成目标Office接口（比如Word的_Application）：

CLSID clsid;
check_hresult(CLSIDFromProgID(L"Word.Application", &clsid));

// 获取已运行的Word实例
wil::com_ptr<IUnknown> unk;
check_hresult(GetActiveObject(clsid, nullptr, unk.put()));

// 转换为Word的_Application接口
wil::com_ptr<_Application> wordApp;
check_hresult(unk.as(&wordApp));

// 调用Activate方法
check_hresult(wordApp->Activate());

如果是C++/WinRT的com_ptr，转换代码更紧凑：

winrt::com_ptr<IUnknown> unk;
winrt::check_hresult(GetActiveObject(clsid, nullptr, unk.put()));

winrt::com_ptr<_Application> wordApp = unk.as<_Application>();
winrt::check_hresult(wordApp->Activate());

3. 接口声明的处理
   要使用_Application这类Office接口，你有两种可行方式：

• 使用#import指令生成头文件：虽然官方文档标注存在问题，但现代环境下可以通过参数规避，比如针对Word：

  #import "C:\Program Files\Microsoft Office\root\Office16\MSWORD.OLB" \
      rename("RGB", "MSRGB") \
      rename("Document", "WordDocument") \
      raw_interfaces_only
  

  raw_interfaces_only参数会生成更贴近原生COM的接口声明，避免冗余包装类，适配现代C++风格。
• 手动声明接口IID和类型：如果你不想用#import，可以从注册表或官方文档获取接口的IID，比如Word的_Application接口IID：

  const IID IID__Application = {0x00020970, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
  

  随后手动声明接口的纯虚函数（这种方式较繁琐，更推荐用#import）。

更简洁的写法：直接获取目标接口 #

其实可以跳过IUnknown的中间步骤，直接让GetActiveObject返回目标接口：

wil::com_ptr<_Application> wordApp;
check_hresult(GetActiveObject(clsid, nullptr, reinterpret_cast<LPUNKNOWN*>(wordApp.put())));
wordApp->Activate();

这种方式减少了一次转换操作，代码更紧凑。

注意事项 #

• 必须保证Office实例已经运行，否则GetActiveObject会失败，此时可以改用CoCreateInstance来启动新的Office实例。
• 所有COM调用的HRESULT都要检查，check_hresult（WIL或C++/WinRT的封装）会在失败时抛出异常，方便统一错误处理。

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