Enum HandleCaptureFailure 

#[non_exhaustive]
pub enum HandleCaptureFailure {
    NullHandle,
    InvalidHandleValue,
    PseudoHandle,
    DuplicateHandle,
    CopySecurity,
}

Why a handle could not be captured.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NullHandle

The source handle was null.

InvalidHandleValue

The source handle was INVALID_HANDLE_VALUE.

Rejected explicitly rather than passed through, because INVALID_HANDLE_VALUE is also the current-process pseudo-handle: DuplicateHandle would accept it and hand back a perfectly valid handle to the current process, so an unchecked CreateFileW failure would be captured as a successful open of something else entirely.

PseudoHandle

The source handle was one of the other Win32 pseudo-handles.

A pseudo-handle names whatever the using thread is, so duplicating one on the caller’s thread and using the result on a worker would silently change what it refers to.

DuplicateHandle

Windows refused to duplicate the source handle.

A handle that has already been closed fails here, with ERROR_INVALID_HANDLE.

CopySecurity

The security attributes a request owns could not be copied, because the memory for the copy could not be allocated.

Reported by a request’s try_clone, which copies them along with any handle it owns.

Trait Implementations

impl Clone for HandleCaptureFailure

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for HandleCaptureFailure

impl Debug for HandleCaptureFailure

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

Formats the value using the given formatter.

impl Eq for HandleCaptureFailure

impl Hash for HandleCaptureFailure

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 HandleCaptureFailure

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for HandleCaptureFailure