Windows-RS项目中使用COM接口调用位置API的注意事项

在Windows-RS项目中调用Windows COM API时，开发者可能会遇到一些意想不到的错误。本文将重点分析一个典型问题：在使用Rust的windows-rs库调用位置API时出现的0x80070032错误，并探讨其解决方案。

问题背景

当开发者尝试使用windows-rs库调用Windows的位置API时，可能会遇到HRESULT错误代码0x80070032（ERROR_NOT_SUPPORTED）。这个错误通常出现在调用ILocation接口的GetDesiredAccuracy方法时。有趣的是，同样的功能在C++中却能正常工作。

错误原因分析

经过深入调查，发现问题根源在于接口标识符（IID）的使用不当。在COM编程中，每个接口都有一个唯一的接口标识符（IID）。当调用COM方法时，必须传递正确的接口标识符。

在Rust代码中，开发者错误地传递了CLSID（类标识符）而不是IID（接口标识符）。具体来说，代码中使用了LatLongReport（一个类标识符）而不是ILatLongReport::IID（接口标识符）。

解决方案

正确的做法是使用接口的IID关联常量。在windows-rs 0.53.0及以上版本中，可以通过以下方式获取接口标识符：

use windows::core::Interface;
let iid = ILatLongReport::IID;

然后将其传递给GetDesiredAccuracy方法：

location.GetDesiredAccuracy(&ILatLongReport::IID as *const GUID)

版本兼容性说明

需要注意的是，不同版本的windows-rs库在接口处理上有所变化：

• 0.52.0及以下版本：需要使用windows::core::ComInterface特性
• 0.53.0及以上版本：统一使用windows::core::Interface特性

开发建议

1. 仔细区分CLSID和IID：在COM编程中，类标识符和接口标识符是不同的概念，必须正确使用。

2. 查阅文档：虽然windows-rs的文档可能不够完善，但理解COM基础概念可以帮助开发者避免这类问题。

3. 版本适配：注意windows-rs不同版本间的API变化，特别是涉及核心特性的修改。

4. 错误处理：对COM方法返回的HRESULT进行充分检查，有助于快速定位问题。

总结

在windows-rs项目中使用COM接口时，确保传递正确的接口标识符至关重要。通过理解COM基础原理和windows-rs库的实现方式，开发者可以避免类似0x80070032这样的错误，顺利实现与Windows系统API的交互。

对于刚接触Windows COM编程的Rust开发者，建议先熟悉COM的基本概念，再结合windows-rs的具体实现进行开发，这样可以减少遇到类似问题的概率。