在 Rust 中使用 Windows COM 自动化：指南

2024-03-12 22:13:22

导言

Windows COM 自动化是一种强大的技术，它允许应用程序通过标准化契约进行跨语言和进程通信。然而，在 Rust 中使用 Windows COM 自动化一直是一项挑战，因为需要对 Windows API 有深入的了解。幸运的是，随着 Windows-RS 板条箱的出现，Rust 开发人员现在可以安全、高效且轻松地访问 Windows API，从而简化了这一过程。

入门

先决条件

在开始之前，请确保您已经安装了以下工具和依赖项：

Rust 稳定版
Windows 10 或更高版本
Windows-RS 板条箱（在你的 Cargo.toml 文件中添加 [dependencies] windows = "0.37"）

设置

首先，我们需要初始化 COM 库。在 main 函数中调用 CoInitializeEx 函数：

use windows::Win32::System::Com;

fn main() -> Result<(), windows::core::Error> {
    unsafe { Com::CoInitializeEx(std::ptr::null(), Com::COINIT_APARTMENTTHREADED) }?;

    // ...

    Ok(())
}

创建 COM 对象

接下来，我们需要获取对象的 CLSID（类标识符），然后使用 CoCreateInstance 函数创建对象：

use windows::Win32::System::{Com, Ole};

let clsid = unsafe { Com::CLSIDFromProgID("bpac.Document") };
let obj: Result<Com::IDispatch, windows::core::Error> = unsafe { Com::CoCreateInstance(&clsid, None, Com::CLSCTX_ALL) };

查询接口

使用 QueryInterface 方法从 COM 对象获取所需接口：

let dispatch: Result<Com::IDispatch, windows::core::Error> = unsafe { obj.QueryInterface::<Com::IDispatch>() };

调用方法

通过 Invoke 方法在接口上调用方法：

let result: Result<(), windows::core::Error> = unsafe { dispatch.Invoke(0, &Ole::IID_NULL, 0, 0, &[], std::ptr::null_mut(), std::ptr::null_mut(), std::ptr::null_mut()) };

案例研究：打开一个 BPAC 文档

以下是使用 Windows-RS 在 Rust 中打开一个 BPAC 文档的完整示例：

use windows::Win32::System::{Com, Ole};

fn main() -> Result<(), windows::core::Error> {
    // 初始化 COM 库
    unsafe { Com::CoInitializeEx(std::ptr::null(), Com::COINIT_APARTMENTTHREADED) }?;

    // 创建 bpac.Document 对象
    let clsid = unsafe { Com::CLSIDFromProgID("bpac.Document") };
    let obj: Result<Com::IDispatch, windows::core::Error> = unsafe { Com::CoCreateInstance(&clsid, None, Com::CLSCTX_ALL) };

    // 查询 IDispatch 接口
    let dispatch: Result<Com::IDispatch, windows::core::Error> = unsafe { obj.QueryInterface::<Com::IDispatch>() };

    // 调用 open 方法
    let result: Result<(), windows::core::Error> = unsafe { dispatch.Invoke(0, &Ole::IID_NULL, 0, 0, &[], std::ptr::null_mut(), std::ptr::null_mut(), std::ptr::null_mut()) };

    // 检查结果
    if result.is_ok() {
        println!("文档已打开！");
    } else {
        println!("无法打开文档！");
    }

    Ok(())
}

结论

通过利用 Windows-RS 板条箱，Rust 开发人员现在可以轻松地与 Windows COM 自动化进行交互。它的现代化接口和符合人体工程学的访问简化了创建 COM 对象、查询接口和调用方法的过程。有了 Windows-RS，Rust 成为利用 Windows COM 自动化的强大平台，为跨语言和进程的通信开辟了新的可能性。