Struct windows::ErrorCode

#[repr(transparent)]
#[must_use]pub struct ErrorCode(pub u32);

A primitive error code value returned by most COM functions. An ErrorCode is sometimes called an HRESULT.

Implementations

impl ErrorCode

pub fn is_ok(self) -> bool

Returns true if self is a success code.

pub fn is_err(self) -> bool

Returns true if self is a failure code.

pub fn unwrap(self)

Asserts that self is a success code.

This will invoke the panic! macro if self is a failure code and display the HRESULT value for diagnostics.

pub fn ok(self) -> Result<()>

Converts the ErrorCode to Result<()>.

pub fn and_some<T: Interface>(self, some: Option<T>) -> Result<T>

Returns the Option as a Result if the option is a Some value, returning a suitable error if not.

pub fn and_then<F, T>(self, op: F) -> Result<T> where
    F: FnOnce() -> T, 

Calls op if self is a success code, otherwise returns ErrorCode converted to Result<T>.

pub unsafe fn from_abi<T: Abi>(self, abi: T::Abi) -> Result<T>

If the Result is Ok converts the T::Abi into T.

pub fn from_thread() -> Self

Retrieves the error code stored on the calling thread.

pub const S_OK: ErrorCode

The operation succeeded.

pub const CO_E_NOTINITIALIZED: ErrorCode

The COM runtime has not been loaded.

pub const E_NOINTERFACE: ErrorCode

The requested interface is not implemented.

pub const E_POINTER: ErrorCode

A null pointer was sent or received.

Trait Implementations

impl Abi for ErrorCode

type Abi = Self

The abi representation of the implementing type.

fn abi(&self) -> Self::Abi

Casts the Rust object to its ABI type without copying the object.

fn set_abi(&mut self) -> *mut Self::Abi

Returns a pointer for setting the object's value via an ABI call.

unsafe fn from_abi(abi: Self::Abi) -> Result<Self>

Casts the ABI representation to a Rust object by taking ownership of the bits.

impl Clone for ErrorCode

fn clone(&self) -> ErrorCode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for ErrorCode

impl Debug for ErrorCode

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

Formats the value using the given formatter.

impl Default for ErrorCode

fn default() -> ErrorCode

Returns the "default value" for a type.

impl From<Error> for ErrorCode

fn from(error: Error) -> Self

Performs the conversion.

impl From<ErrorCode> for Error

fn from(code: ErrorCode) -> Self

Performs the conversion.

impl<T> From<Result<T, Error>> for ErrorCode

fn from(result: Result<T>) -> Self

Performs the conversion.

impl PartialEq<ErrorCode> for ErrorCode

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

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

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

This method tests for !=.

impl StructuralPartialEq for ErrorCode