Struct Win32Error 

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

A raw Win32 error code, exactly as Windows produced it.

Deliberately not an enum: the point of this type is that it carries whatever Windows said, including codes this crate has never heard of.

Example

use windows_namespace_request_sys::Win32Error;
use windows_sys::Win32::Foundation::ERROR_FILE_NOT_FOUND;

let error = Win32Error::from_code(ERROR_FILE_NOT_FOUND);
assert_eq!(error.code(), ERROR_FILE_NOT_FOUND);

// The io::Error form is a re-presentation, not a reclassification: the raw
// code survives it.
assert_eq!(error.to_io_error().raw_os_error(), Some(ERROR_FILE_NOT_FOUND as i32));

// A code this crate has never heard of is carried just the same.
let unknown = Win32Error::from_code(0x0BAD_F00D);
assert_eq!(unknown.code(), 0x0BAD_F00D);

Implementations

impl Win32Error

pub fn from_code(code: WIN32_ERROR) -> Self

Wraps a raw WIN32_ERROR.

pub fn code(self) -> WIN32_ERROR

The raw code, unaltered.

pub fn to_io_error(self) -> Error

The same failure as a standard io::Error, for callers that funnel everything through std::io.

This is a re-presentation, not a reclassification: the raw code survives as io::Error::raw_os_error.

Trait Implementations

impl Clone for Win32Error

fn clone(&self) -> Win32Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Win32Error

impl Debug for Win32Error

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

Formats the value using the given formatter.

impl Display for Win32Error

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

Formats the value using the given formatter.

impl Eq for Win32Error

impl Error for Win32Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

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

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Win32Error> for FinalPathError

fn from(error: Win32Error) -> Self

Converts to this type from the input type.

impl From<Win32Error> for FullPathError

fn from(error: Win32Error) -> Self

Converts to this type from the input type.

impl Hash for Win32Error

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Win32Error

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Win32Error