Struct windows_core::IUnknown

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

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) -> Self

Returns a copy 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

Formats the value using the given formatter.

impl Drop for IUnknown

fn drop(&mut self)

Executes the destructor for this type.

impl From<&IInspectable> for &IUnknown

fn from(value: &IInspectable) -> Self

Converts to this type from the input type.

impl From<IInspectable> for IUnknown

fn from(value: IInspectable) -> Self

Converts to this type from the input type.

impl From<IUnknown> for PROPVARIANT

fn from(value: IUnknown) -> Self

Converts to this type from the input type.

impl From<IUnknown> for VARIANT

fn from(value: IUnknown) -> Self

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: Interface>(&self) -> Result<T>

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

fn cast_to_any<T>(&self) -> Result<&dyn Any>

where T: ComObjectInner, T::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::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::Outer>

where T: ComObjectInner, T::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>>

where T: ComObjectInner, T::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>>

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: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl TryFrom<&PROPVARIANT> for IUnknown

type Error = Error

The type returned in the event of a conversion error.

fn try_from(from: &PROPVARIANT) -> Result<Self>

Performs the conversion.

impl TryFrom<&VARIANT> for IUnknown

type Error = Error

The type returned in the event of a conversion error.

fn try_from(from: &VARIANT) -> Result<Self>

Performs the conversion.

impl Eq for IUnknown