Struct ThreadErrorMode 

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

A thread error mode, restricted to the bits Windows accepts per thread.

Construct one from the associated constants and union, or from a raw value with from_bits.

Implementations

impl ThreadErrorMode

pub const NONE: Self

No bits set: hard errors raise the system’s dialogs.

pub const FAIL_CRITICAL_ERRORS: Self

Fail calls that hit a critical error instead of raising a dialog.

pub const NO_GP_FAULT_ERROR_BOX: Self

Suppress the general-protection-fault error box.

pub const NO_OPEN_FILE_ERROR_BOX: Self

Suppress the file-open error box.

pub const fn bits(self) -> THREAD_ERROR_MODE

The raw value, as Win32 represents it.

pub const fn from_bits(bits: THREAD_ERROR_MODE) -> Result<Self, UnsupportedBits>

Build a mode from a raw value.

Errors

Returns UnsupportedBits if bits contains anything SetThreadErrorMode does not accept. This is a rejection rather than a mask: silently dropping a bit would report installing a value that was not installed, which is the failure this type exists to prevent.

Example

use windows_thread_ambient_sys::ThreadErrorMode;

assert_eq!(
    ThreadErrorMode::from_bits(0x0001),
    Ok(ThreadErrorMode::FAIL_CRITICAL_ERRORS)
);

// 0x0004 is SEM_NOALIGNMENTFAULTEXCEPT, which cannot be set per thread.
// It is refused even beside a valid bit, because Windows would install
// neither: an invalid bit fails the whole call.
let refused = ThreadErrorMode::from_bits(0x0001 | 0x0004)
    .expect_err("the alignment bit is not settable per thread");
assert_eq!(refused.bits(), 0x0004);

pub const fn union(self, other: Self) -> Self

Both modes’ bits.

pub const fn contains(self, other: Self) -> bool

Whether every bit of other is set.

pub const fn is_empty(self) -> bool

Whether no bits are set.

pub fn capture() -> Result<Self, UnsupportedBits>

Read the calling thread’s current mode.

Errors

Returns UnsupportedBits if Windows reports a bit this type cannot hold. Measured, that does not happen: the thread error mode is independent storage rather than a view of the process error mode, so a process-scope bit such as SEM_NOALIGNMENTFAULTEXCEPT does not show through here. The result is still surfaced rather than assumed away, because a type unable to represent a state the platform can produce would be a bug, and this is where that would first be observable.

pub fn apply(self) -> Result<ErrorModeGuard, ApplyError>

Install this mode on the calling thread until the guard is released.

Errors

Returns ApplyError if Windows refuses the value, in which case nothing was installed and the thread is untouched.

Trait Implementations

impl Clone for ThreadErrorMode

fn clone(&self) -> ThreadErrorMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ThreadErrorMode

impl Debug for ThreadErrorMode

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

Formats the value using the given formatter.

impl Default for ThreadErrorMode

fn default() -> ThreadErrorMode

Returns the “default value” for a type.

impl Display for ThreadErrorMode

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

Formats the value using the given formatter.

impl Eq for ThreadErrorMode

impl Hash for ThreadErrorMode

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 ThreadErrorMode

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ThreadErrorMode