Struct ComPtr 

pub struct ComPtr<T: Interface> { /* private fields */ }

Owning, non-null COM interface pointer: holds exactly one reference.

Not Send/Sync: the native objects are UI-thread affine.

Implementations

impl<T: Interface> ComPtr<T>

pub unsafe fn from_raw(raw: *mut T) -> Option<Self>

Takes ownership of one existing reference (no AddRef). Returns None for null.

Safety

raw must be null or a valid pointer to a COM object implementing T whose reference the caller owns.

pub unsafe fn from_raw_add_ref(raw: *mut T) -> Option<Self>

AddRefs a borrowed pointer and wraps it. Returns None for null.

Safety

raw must be null or a valid pointer to a COM object implementing T.

pub fn from_ref(r: &T) -> Self

AddRefs a borrowed interface reference.

pub fn as_ptr(&self) -> *mut T

Borrowed raw pointer; the reference count is unchanged.

pub fn into_raw(self) -> *mut T

Gives up ownership without releasing.

pub fn cast<U: Interface>(&self) -> Result<ComPtr<U>, HResult>

QueryInterface for U.

The native library compares against the IIDs materialized by com.h (see crate::Guid::as_com_h_materialized), Rust-implemented objects accept both forms; so the materialized form is tried first and the IDL form second.

Trait Implementations

impl<T: Interface> Clone for ComPtr<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Interface> Debug for ComPtr<T>

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

Formats the value using the given formatter.

impl<T: Interface> Deref for ComPtr<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T: Interface> Drop for ComPtr<T>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl<T: Interface> PartialEq for ComPtr<T>

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.