Enum oaidl::FromSafeArrayError

pub enum FromSafeArrayError {
    SafeArrayDimsInvalid {
        sa_dims: u32,
    },
    VarTypeDoesNotMatch {
        expected: u32,
        found: u32,
    },
    SafeArrayLBoundFailed {
        hr: i32,
    },
    SafeArrayRBoundFailed {
        hr: i32,
    },
    SafeArrayGetVartypeFailed {
        hr: i32,
    },
    ElementConversionFailed {
        index: usize,
        element: Box<ElementError>,
    },
    FromVariantError(Box<FromVariantError>),
}

Represents the different ways converting from SAFEARRAY can fail

Variants

SafeArrayDimsInvalid

Fields

sa_dims: u32

safe array dimensions that was wrong

Either the safe array dimensions = 0 or > 1 multi-dimensional arrays are not handled.

VarTypeDoesNotMatch

Fields

expected: u32

The expected vartype

found: u32

the found vartype

Expected vartype did not match found vartype - runtime consistency check

SafeArrayLBoundFailed

Fields

hr: i32

HRESULT returned

Call to SafeArrayGetLBound failed

SafeArrayRBoundFailed

Fields

hr: i32

HRESULT returned

Call to SafeArrayGetRBound failed

SafeArrayGetVartypeFailed

Fields

hr: i32

HRESULT returned

Call to SafeArrayGetVartype failed

ElementConversionFailed

Fields

index: usize

the index the conversion failed at

element: Box<ElementError>

The element error encapsulating the failure

Encapsulates the ElementError that occurred during conversion

FromVariantError(Box<FromVariantError>)

[from_variant] call failed

Implementations

impl FromSafeArrayError

pub fn from_element_err<E: Into<ElementError>>( ee: E, index: usize ) -> FromSafeArrayError

Boxes an ElementError into a FromSafeArrayError.

Need the index so a From impl doesn’t apply.

Trait Implementations

impl Debug for FromSafeArrayError

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

Formats the value using the given formatter.

impl Display for FromSafeArrayError

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

Formats the value using the given formatter.

impl Fail for FromSafeArrayError

fn name(&self) -> Option<&str>

Returns the “name” of the error.

fn cause(&self) -> Option<&dyn Fail>

Returns a reference to the underlying cause of this failure, if it is an error that wraps other errors.

fn backtrace(&self) -> Option<&Backtrace>

Returns a reference to the Backtrace carried by this failure, if it carries one.

fn context<D>(self, context: D) -> Context<D>where D: Display + Send + Sync + 'static, Self: Sized,

Provides context for this failure.

fn compat(self) -> Compat<Self>where Self: Sized,

Wraps this failure in a compatibility wrapper that implements std::error::Error.

impl From<FromSafeArrayError> for SafeArrayError

fn from(fsae: FromSafeArrayError) -> SafeArrayError

Holds a FromSafeArrayError with a box. This means conversion is free.

impl From<FromVariantError> for FromSafeArrayError

fn from(fve: FromVariantError) -> Self

Boxes a FromVariantError into a FromSafeArrElemError which means the conversion is free.