Trait ISupportErrorInfo

pub trait ISupportErrorInfo: IUnknown {
    // Required method
    fn interface_supports_error_info(&self, riid: REFIID) -> HRESULT;
}

The ISupportErrorInfo COM interface.

The ISupportErrorInfo is part of COM error handling concept. As the methods are traditionally limited to HRESULT return values, they may make more detailed IErrorInfo data available through the error info APIs.

The ISupportErrorInfo interface communicates which interfaces that an object implements support detailed error info. When a COM client receives an error-HRESULT, it may query for error info support through this interface. If the interface returns an S_OK as opposed to S_FALSE return value, the client can then use separate error info APIs to retrieve a detailed IErrorInfo object that contains more details about the error, such as the error message.

Intercom COM classes support the detailed error info for all user specified interfaces automatically. Only methods that return a two-parameter Result<S,E> value will store the detailed IErrorInfo. Other methods will set a null IErrorInfo value.

Required Methods

fn interface_supports_error_info(&self, riid: REFIID) -> HRESULT

Informs the current COM class supports IErrorInfo for a specific interface.

• riid - The IID of the interface to query.

Returns S_OK if the object supports IErrorInfo for the interface specified by the riid parameter. Otherwise returns S_FALSE - even in the case the object doesn’t implement riid at all.

Description

If the object returns S_OK for an interface, then any methods the object implements for that interface must store the IErrorInfo on failure.

Intercom will implement the support for IErrorInfo automatically for all custom interfaces the user defines. This includes returning S_OK from this method.

Trait Implementations

impl ComClassInterface<dyn ISupportErrorInfo, AutomationTypeSystem> for Allocator

fn offset() -> usize

unsafe fn get_box<'a>(vtable: RawComPtr) -> &'a mut ComBoxData<Self>

Safety

impl ComClassInterface<dyn ISupportErrorInfo, AutomationTypeSystem> for CoClass

fn offset() -> usize

unsafe fn get_box<'a>(vtable: RawComPtr) -> &'a mut ComBoxData<Self>

Safety

impl ComClassInterface<dyn ISupportErrorInfo, AutomationTypeSystem> for ErrorInfo

fn offset() -> usize

unsafe fn get_box<'a>(vtable: RawComPtr) -> &'a mut ComBoxData<Self>

Safety

impl ComClassInterface<dyn ISupportErrorInfo, AutomationTypeSystem> for ErrorStore

fn offset() -> usize

unsafe fn get_box<'a>(vtable: RawComPtr) -> &'a mut ComBoxData<Self>

Safety

impl ComClassInterface<dyn ISupportErrorInfo, AutomationTypeSystem> for Interface

fn offset() -> usize

unsafe fn get_box<'a>(vtable: RawComPtr) -> &'a mut ComBoxData<Self>

Safety

impl ComClassInterface<dyn ISupportErrorInfo, AutomationTypeSystem> for InterfaceVariant

fn offset() -> usize

unsafe fn get_box<'a>(vtable: RawComPtr) -> &'a mut ComBoxData<Self>

Safety

impl ComClassInterface<dyn ISupportErrorInfo, AutomationTypeSystem> for Method

fn offset() -> usize

unsafe fn get_box<'a>(vtable: RawComPtr) -> &'a mut ComBoxData<Self>

Safety

impl ComClassInterface<dyn ISupportErrorInfo, AutomationTypeSystem> for TypeLib

fn offset() -> usize

unsafe fn get_box<'a>(vtable: RawComPtr) -> &'a mut ComBoxData<Self>

Safety

impl ComInterface for dyn ISupportErrorInfo

fn iid_ts<TS: TypeSystem>() -> &'static IID

where Self: ComInterfaceVariant<TS>,

Returns the IID of the requested interface.

type TSelf = dyn ISupportErrorInfo

The current interface.

fn iid(ts: TypeSystemName) -> Option<&'static IID>

IID of the COM interface.

fn deref( com_itf: &ComItf<dyn ISupportErrorInfo>, ) -> &(dyn ISupportErrorInfo + 'static)

Dereferences a ComItf<T> into a &T.

impl ComInterfaceTypeInfo for dyn ISupportErrorInfo

fn gather_type_info() -> Vec<TypeInfo>

impl<I, S> ComInterfaceVTableFor<I, S, AutomationTypeSystem> for dyn ISupportErrorInfo

where I: ?Sized, S: ComClassInterface<I, AutomationTypeSystem> + ComClass,

const VTABLE: __ISupportErrorInfoAutomationVTable

impl<I, S> ComInterfaceVTableFor<I, S, RawTypeSystem> for dyn ISupportErrorInfo

where I: ?Sized, S: ComClassInterface<I, RawTypeSystem> + ComClass,

const VTABLE: __ISupportErrorInfoRawVTable

impl ForeignType for dyn ISupportErrorInfo

fn type_name() -> &'static str

The name of the type.

fn indirection_level() -> u32

Implementors

impl<I: ComInterface + ISupportErrorInfo + ?Sized> ISupportErrorInfo for ComItf<I>