Struct windows_core::HRESULT

#[repr(transparent)]
pub struct HRESULT(pub i32);

An error code value returned by most COM functions.

Tuple Fields

0: i32

Implementations

impl HRESULT

pub const fn is_ok(self) -> bool

Returns true if self is a success code.

pub const 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 HRESULT 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 HRESULT converted to Result<T>.

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

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

Safety

Safe to call if

• abi is initialized if self is Ok
• abi can be safely transmuted to T

pub fn message(&self) -> HSTRING

The error message describing the error.

pub const fn from_win32(error: u32) -> Self

Maps a Win32 error code to an HRESULT value.

Trait Implementations

impl Clone for HRESULT

fn clone(&self) -> HRESULT

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for HRESULT

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

Formats the value using the given formatter.

impl Default for HRESULT

fn default() -> HRESULT

Returns the “default value” for a type.

impl Display for HRESULT

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

Formats the value using the given formatter.

impl From<Error> for HRESULT

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<HRESULT> for Error

fn from(code: HRESULT) -> Self

Converts to this type from the input type.

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

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

Converts to this type from the input type.

impl PartialEq for HRESULT

fn eq(&self, other: &HRESULT) -> 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 Copy for HRESULT

impl Eq for HRESULT

impl StructuralEq for HRESULT

impl StructuralPartialEq for HRESULT