callcomapi_macros

callcomapi_macros is a Rust procedural macro crate that simplifies calling COM APIs. It reduces the boilerplate for Windows COM initialization and cleanup.

This crate is intended for Rust projects that need to call Windows COM APIs frequently.

Usage

Add callcomapi_macros as a dependency in your Cargo.toml, Then you can use the provided macros in your Rust code.

use callcomapi_macros::{with_com, com_thread};

// 1. Automatically initialize COM and ensure cleanup when the function returns
#[with_com]
fn my_com_function() {
    // Call COM APIs here
}

// 2. Convert a synchronous or asynchronous function to run on a dedicated
//    background COM thread that stays alive and is reused.
#[com_thread]
fn run_on_com_thread(x: i32) -> i32 {
    x * 2
}

示例

You can check the examples folder for more usage details:

• with_com.rs: demonstrates scoping COM lifetime within a function.
• com_thread.rs: demonstrates using a persistent background thread to call COM.