Struct ComGuard 

pub struct ComGuard { /* private fields */ }

Drop guard for COM thread initialization.

Calling ComGuard::new initializes COM in Multi-Threaded Apartment (MTA) mode. When the guard is dropped, CoUninitialize is called automatically.

Thread Safety

ComGuard is intentionally !Send and !Sync. COM initialization is per-thread — the guard must be created and dropped on the same OS thread. This is enforced at compile time.

Examples

let _guard = ComGuard::new()?;
// ... COM operations ...
// CoUninitialize called automatically on drop

Implementations

impl ComGuard

pub fn new() -> Result<Self>

Initialize COM in Multi-Threaded Apartment (MTA) mode.

Returns Ok(ComGuard) on success (including S_FALSE, which means COM was already initialized on this thread).

Errors

Returns Err if CoInitializeEx fails with a fatal HRESULT.

Trait Implementations

impl Debug for ComGuard

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

Formats the value using the given formatter.

impl Drop for ComGuard

fn drop(&mut self)

Executes the destructor for this type.