wmi

What's Changed

• Add compatibility with multiple windows crate versions by @ohadravid in #144

Full Changelog: v0.18.1...v0.18.2

What's Changed

• Added WMIConnection::{put_instance,delete_instance} by @pronebird in #141

Full Changelog: v0.18.0...v0.18.1

What's Changed

• Remove COMLibrary and let WMIConnection initialize COM if needed by @ohadravid in #137
  You can now call WMIConnection::new() and let the crate handle the initialization internally.
  Note: COM will NOT be uninitialized when the connection is dropped (similar to <=0.17 versions, which didn't uninitialize COM on drop since #53).
  If this is not what you want, then you must initialize COM yourself before creating the connection. See the docs for more.
• Update the crate to Rust 2024 edition

Full Changelog: v0.17.3...v0.18.0

What's Changed

• chore(deps): update criterion requirement from 0.5 to 0.6 by @dependabot[bot] in #128
• Update CI images by @ohadravid in #135
• chore(deps): update windows requirement from 0.61 to 0.62 by @dependabot[bot] in #134

Full Changelog: v0.17.2...v0.17.3

What's Changed

• feat(remote_connection): added with_credentials() by @hatch15 in #127

New Contributors

• @hatch15 made their first contribution in #127

Full Changelog: v0.17.1...v0.17.2

What's Changed

• Support arrays of IUnknown pointers by @samin-cf in #125 and @ohadravid in #126

Full Changelog: v0.17.0...v0.17.1

What's Changed

• Added support for Option by @vpopescu in #122

Breaking Changes

• Fixed conversions from Rust types to WMI types (so, only when used for method calling or using put_property), which were incorrect in a few cases (notably, u32s and u16s were not converted correctly), and added some missing conversions, in #124
• SafeArrayAccessor::new now accepts a NonNull<SAFEARRAY> instead of a reference, in #124

New Contributors

• @vpopescu made their first contribution in #122

Full Changelog: v0.16.0...v0.17.0

This version adds support for more serialization inputs (nested structures, array), and changes the public API to be more cohesive.

New Features

Nested structrure can be serialized when provided as method parameters (#120):

let in_params = CreateInput {
    CommandLine: "explorer.exe".to_string(),
    ProcessStartupInformation: Win32_ProcessStartup {
        PriorityClass: 128, // High priority.
    },
};
let out: CreateOutput = wmi_con
    .exec_class_method::<Win32_Process, _>("Create", in_params)?;

Arrays can be serialized when provided as method parameters (#121):

#[derive(Deserialize, Serialize)]
struct SetBinaryValue {
    sSubKeyName: String,
    sValueName: String,
    uValue: Vec<u8>,
}

let test_value = vec![0, 1, 2, 3];

let set_binary_value_params = SetBinaryValue {
    // ..
    uValue: test_value,
};

let value: SetBinaryValueOut = wmi_con
    .exec_class_method::<StdRegProv, _>("SetBinaryValue", &set_binary_value_params)?;

More lower-level API functions are exposed for IWbemClassWrapper:

let in_params = wmi_con
    .get_object("Win32_Process")?
    .get_method("Create")?
    .unwrap() // Can be `None`.
    .spawn_instance()?;

in_params
    .put_property("CommandLine", "explorer.exe".to_string())?;

let out = wmi_con
    .exec_method("Win32_Process", "Create", Some(&in_params))?;

Breaking Changes

1. Method calling API was changed a little (#120):

// Before:
let output: CreateOutput = wmi_con.exec_class_method::<Win32_Process, _, _>("Create", input)?;
let output: PrinterOutput = wmi_con.exec_instance_method::<Win32_Printer, _, _>("Pause", &printer.__Path, ())?;
// Now, only the Class and Out generics are named:
let output: CreateOutput = wmi_con.exec_class_method::<Win32_Process, _>("Create", input)?;
let output: PrinterOutput = wmi_con.exec_instance_method::<Win32_Printer, _>(&printer.__Path, "Pause", ())?;

1. Rename lower-level (_native) methods to match the original names (exec_method_native_wrapper -> exec_method, exec_query_native_wrapper -> exec_query, etc.)
2. Only expose as pub the needed structures and functions.

What's Changed

• Split method-calling logic between IWbemClassWrapper and WMIConnection, rename lower-level functions by @ohadravid in #120
• Support Array Serialization by @ohadravid in #121

Full Changelog: v0.15.2...v0.16.0