wincom 0.3.0

A lightweight Rust wrapper for Windows COM IDispatch automation, providing RAII VARIANT management and simplified property/method invocation.
Documentation

wincom

A lightweight Rust wrapper for Windows COM IDispatch automation.

wincom focuses on the late-binding path that most scripting hosts (AutoCAD, CorelDRAW, Office, …) expose. It provides:

  • ComObject — wraps an IDispatch and offers name-based property reads/writes and method invocation.
  • Variant — a RAII wrapper over VARIANT that calls VariantClear on drop, eliminating a common source of leaks.
  • Conversions — i16/i32/i64, u8/u16/u32/u64, f64, bool, String, and Vec<f64> in both directions.

Example

use wincom::{ComObject, Variant};

fn main() -> wincom::Result<()> {
    // Bind to a running CorelDRAW instance.
    let app = ComObject::new_from_active("CorelDRAW.Application")?;

    // Read a property.
    let version: String = app.get_property("Version")?.to_string()?;
    println!("CorelDRAW version: {version}");

    // Write a property.
    app.set_property("Visible", vec![Variant::from_bool(true)])?;

    // Call a method.
    let _doc = app.invoke_method("AddDocument", Vec::new())?;
    Ok(())
}

COM must already be initialized on the calling thread:

use windows::Win32::System::Com;
unsafe { Com::CoInitialize(None).ok()? };
// ... use ComObject ...
unsafe { Com::CoUninitialize() };

Platform

Windows only. On other platforms the crate compiles to an empty library (#![cfg(windows)]).

Threading

ComObject is not Send or Sync. COM objects are apartment-bound; marshal them explicitly if you need cross-thread access.

Minimum supported Rust version

Rust 1.71 or later.

License

Licensed under either of

at your option.