Struct IUnknown 

pub struct IUnknown(/* private fields */);

Base interface for all COM interfaces.

All COM interfaces (and thus WinRT classes and interfaces) implement IUnknown under the hood to provide reference-counted lifetime management as well as the ability to query for additional interfaces that the object may implement.

Trait Implementations

impl Clone for IUnknown

fn clone(&self) -> IUnknown

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IUnknown

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

Formats the value using the given formatter.

impl Drop for IUnknown

fn drop(&mut self)

Executes the destructor for this type.

impl From<&IAgileObject> for &IUnknown

fn from(value: &IAgileObject) -> &IUnknown

Converts to this type from the input type.

impl From<&IAgileReference> for &IUnknown

fn from(value: &IAgileReference) -> &IUnknown

Converts to this type from the input type.

impl From<&IInspectable> for &IUnknown

fn from(value: &IInspectable) -> &IUnknown

Converts to this type from the input type.

impl From<&IWeakReference> for &IUnknown

fn from(value: &IWeakReference) -> &IUnknown

Converts to this type from the input type.

impl From<&IWeakReferenceSource> for &IUnknown

fn from(value: &IWeakReferenceSource) -> &IUnknown

Converts to this type from the input type.

impl From<IAgileObject> for IUnknown

fn from(value: IAgileObject) -> IUnknown

Converts to this type from the input type.

impl From<IAgileReference> for IUnknown

fn from(value: IAgileReference) -> IUnknown

Converts to this type from the input type.

impl From<IInspectable> for IUnknown

fn from(value: IInspectable) -> IUnknown

Converts to this type from the input type.

impl From<IWeakReference> for IUnknown

fn from(value: IWeakReference) -> IUnknown

Converts to this type from the input type.

impl From<IWeakReferenceSource> for IUnknown

fn from(value: IWeakReferenceSource) -> IUnknown

Converts to this type from the input type.

impl Interface for IUnknown

const IID: GUID

The GUID associated with the interface.

fn as_raw(&self) -> *mut c_void

Returns the raw COM interface pointer. The resulting pointer continues to be owned by the Interface implementation.

fn into_raw(self) -> *mut c_void

Returns the raw COM interface pointer and releases ownership. It the caller’s responsibility to release the COM interface pointer.

unsafe fn from_raw(raw: *mut c_void) -> Self

Creates an Interface by taking ownership of the raw COM interface pointer.

unsafe fn from_raw_borrowed(raw: &*mut c_void) -> Option<&Self>

Creates an Interface that is valid so long as the raw COM interface pointer is valid.

fn cast<T>(&self) -> Result<T, Error>

where T: Interface,

Attempts to cast the current interface to another interface using QueryInterface.

fn cast_to_any<T>(&self) -> Result<&(dyn Any + 'static), Error>

where T: ComObjectInner, <T as ComObjectInner>::Outer: Any + 'static + IUnknownImpl<Impl = T>,

This casts the given COM interface to [&dyn Any].

fn is_object<T>(&self) -> bool

where T: ComObjectInner, <T as ComObjectInner>::Outer: Any + 'static + IUnknownImpl<Impl = T>,

Returns true if the given COM interface refers to an implementation of T.

fn cast_object_ref<T>(&self) -> Result<&<T as ComObjectInner>::Outer, Error>

where T: ComObjectInner, <T as ComObjectInner>::Outer: Any + 'static + IUnknownImpl<Impl = T>,

This casts the given COM interface to [&dyn Any]. It returns a reference to the “outer” object, e.g. &MyApp_Impl, not the inner &MyApp object.

fn cast_object<T>(&self) -> Result<ComObject<T>, Error>

where T: ComObjectInner, <T as ComObjectInner>::Outer: Any + 'static + IUnknownImpl<Impl = T>,

This casts the given COM interface to [&dyn Any]. It returns a reference to the “outer” object, e.g. MyApp_Impl, not the inner MyApp object.

fn downgrade(&self) -> Result<Weak<Self>, Error>

Attempts to create a Weak reference to this object.

unsafe fn query(&self, iid: *const GUID, interface: *mut *mut c_void) -> HRESULT

Call QueryInterface on this interface

fn to_ref(&self) -> InterfaceRef<'_, Self>

Creates an InterfaceRef for this reference. The InterfaceRef tracks lifetimes statically, and eliminates the need for dynamic reference count adjustments (AddRef/Release).

impl PartialEq for IUnknown

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for IUnknown