如何从C# WinRT组件向C++返回非基元类型及调用异步方法

核心根因 #

你遇到的Class not registered错误和C#组件代码本身无关，问题出在免注册WinRT的清单配置：当返回IAsyncOperation、IDictionary/IList这类非基元WinRT类型时，运行时需要激活.NET内置的WinRT类型投影适配器类，这些类的注册信息没有被包含在你的Win32控制台应用的免注册清单中，所以触发了注册错误。

修复步骤 #

1. 确认C#代码正确性 #

你现有的C#代码不需要修改：

• 异步方法返回IAsyncOperation<T>、用Task<T>.AsAsyncOperation()转换是标准正确写法
• 集合方法直接返回IDictionary<int, string>/IList<T>即可，不需要手动使用IMap/IVector接口，.NET运行时会自动完成托管类型到WinRT类型的投影。你遇到的IMap保护级别错误是因为.NET没有公开这个接口的直接实现给用户调用，直接用BCL集合类型即可。

2. 更新Win32应用的免注册WinRT清单 #

在你的控制台应用的.manifest文件中，额外添加.NET WinRT适配器的注册条目：

<!-- 放在应用manifest的file节点下 -->
<file name="System.Runtime.WindowsRuntime.dll">
  <activatableClass
    name="System.Runtime.InteropServices.WindowsRuntime.IAsyncOperationAbi`1"
    threadingModel="both"
    runtimeVersion="v4.0.30319"/>
  <activatableClass
    name="System.Runtime.InteropServices.WindowsRuntime.MapAdapter`2"
    threadingModel="both"
    runtimeVersion="v4.0.30319"/>
  <activatableClass
    name="System.Runtime.InteropServices.WindowsRuntime.VectorAdapter`1"
    threadingModel="both"
    runtimeVersion="v4.0.30319"/>
  <!-- 如果用到IAsyncAction类型的异步方法，补充以下条目 -->
  <activatableClass
    name="System.Runtime.InteropServices.WindowsRuntime.IAsyncActionAbi"
    threadingModel="both"
    runtimeVersion="v4.0.30319"/>
</file>

注意runtimeVersion的值要和你项目使用的.NET版本对应，如果你用的是.NET 5+的CsWinRT生成组件，需要把对应CsWinRT运行时dll的注册条目也补充到清单中。

3. 确认依赖文件部署 #

把以下文件和你的控制台应用、自定义WinRT组件放在同一目录：

• System.Runtime.WindowsRuntime.dll
• 如果你使用.NET 6+的CsWinRT生成组件，额外带上Microsoft.Windows.SDK.NET.dll和WinRT.Runtime.dll

完成以上操作后，集合方法和异步方法都可以正常调用，不会再触发注册错误。

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