Struct wmi::connection::COMLibrary

pub struct COMLibrary { /* private fields */ }

A marker to indicate that the current thread was CoInitialized.

Note

COMLibrary should be treated as a singleton per thread:

thread_local! {
    static COM_LIB: COMLibrary = COMLibrary::new().unwrap();
}

pub fn wmi_con() -> WMIConnection {
    let com_lib = COM_LIB.with(|com| *com);
    WMIConnection::new(com_lib).unwrap()
}

Implementations

impl COMLibrary

Initialize COM.

CoUninitialize will NOT be called when dropped. See: https://github.com/microsoft/windows-rs/issues/1169#issuecomment-926877227

pub fn new() -> WMIResult<Self>

CoInitializes the COM library for use by the calling thread.

pub fn without_security() -> WMIResult<Self>

CoInitializes the COM library for use by the calling thread, but without setting the security context.

pub unsafe fn assume_initialized() -> Self

Assumes that COM was already initialized for this thread.

Safety

This function is unsafe as it is the caller’s responsibility to ensure that COM is initialized and will not be uninitialized while any instance of object is in scope.

let initialized_com = unsafe { COMLibrary::assume_initialized() };

// Later, in the same thread.
let wmi_con = WMIConnection::with_namespace_path("ROOT\\CIMV2", initialized_com)?;

Trait Implementations

impl Clone for COMLibrary

fn clone(&self) -> COMLibrary

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for COMLibrary

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Copy for COMLibrary