Struct intercom::ComRc

pub struct ComRc<T: ComInterface + ?Sized> { /* private fields */ }

Reference counted handle to the ComBox data.

Provides a safe way to handle the unsafe ComBox values.

Implementations

impl<T: ComInterface + ?Sized> ComRc<T>

pub unsafe fn attach(itf: ComItf<T>) -> ComRc<T>

Attaches a floating ComItf reference and brings it under managed reference counting.

Does not increment the reference count.

Safety

Given this does not increment the reference count, it must be used only if the ComItf is one that would leave the reference dangling. If something already owns the ComItf and will do release on it, the drop of the returned ComRc will result in a double-release.

pub fn detach(rc: ComRc<T>) -> ComItf<T>

Attaches a floating ComItf reference and brings it under managed reference counting.

Does not increment the reference count.

pub unsafe fn wrap<TS: TypeSystem>(ptr: InterfacePtr<TS, T>) -> ComRc<T>

Creates a ComItf<T> from a raw type system COM interface pointer..

Does not increment the reference count.

Safety

The ptr must be owned by us. wrap will not call add_ref on the ptr.

Methods from Deref<Target = ComItf<T>>

pub fn as_raw_iunknown(&self) -> &ComItf<dyn RawIUnknown>

pub fn as_iunknown(&self) -> &ComItf<dyn IUnknown>

Trait Implementations

impl<T: ComInterface + ?Sized> AsRef<ComItf<T>> for ComRc<T>

fn as_ref(&self) -> &ComItf<T>

Converts this type into a shared reference of the (usually inferred) input type.

impl<T: ComInterface + ?Sized> Borrow<ComItf<T>> for ComRc<T>

fn borrow(&self) -> &ComItf<T>

Immutably borrows from an owned value.

impl<T: ComInterface + ?Sized> Clone for ComRc<T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: ComInterface + ?Sized> Debug for ComRc<T>

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

Formats the value using the given formatter.

impl<T: ComInterface + ?Sized> Deref for ComRc<T>

type Target = ComItf<T>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T: ComInterface + ?Sized> Drop for ComRc<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<TS: TypeSystem, I: ComInterface + ?Sized> ExternInput<TS> for ComRc<I> where
    I: ForeignType, 

type Lease = ComRc<I>

unsafe fn into_foreign_parameter(
    self
) -> ComResult<(Self::ForeignType, Self::Lease)>

Safety

type Owned = ComRc<I>

unsafe fn from_foreign_parameter(source: Self::ForeignType) -> ComResult<Self>

Safety

impl<TS: TypeSystem, I: ComInterface + ?Sized> ExternOutput<TS> for ComRc<I> where
    I: ForeignType, 

fn into_foreign_output(self) -> ComResult<Self::ForeignType>

unsafe fn from_foreign_output(source: Self::ForeignType) -> ComResult<Self>

Safety

unsafe fn drop_foreign_output(source: Self::ForeignType)

Safety

impl<TS: TypeSystem, I: ComInterface + ?Sized> ExternType<TS> for ComRc<I> where
    I: ForeignType, 

type ForeignType = Option<InterfacePtr<TS, I>>

impl<I: ComInterface + ?Sized, T: HasInterface<I>> From<&ComBox<T>> for ComRc<I>

fn from(combox: &ComBox<T>) -> Self

Converts to this type from the input type.

impl<T: ComInterface + ?Sized> From<&ComItf<T>> for ComRc<T>

fn from(source: &ComItf<T>) -> Self

Converts to this type from the input type.

impl<I: ComInterface + ?Sized, T: HasInterface<I>> From<ComBox<T>> for ComRc<I>

fn from(source: ComBox<T>) -> ComRc<I>

Converts to this type from the input type.

impl<T: ComInterface + ?Sized> From<ComRc<T>> for Variant

fn from(src: ComRc<T>) -> Self

Converts to this type from the input type.

impl<TS: TypeSystem, T: ComInterface + ?Sized> From<InterfacePtr<TS, T>> for ComRc<T>

fn from(source: InterfacePtr<TS, T>) -> Self

Converts to this type from the input type.