Enum RequestFailure 

#[non_exhaustive]
pub enum RequestFailure {
    EmptyPath,
    InteriorNul,
    PathTooLong,
    NotFullyQualified,
    PathResolution,
    BufferCapacityUnrepresentable,
}

Why a request could not be built.

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.

EmptyPath

The path had no code units. An empty path names no directory.

InteriorNul

The path contained an interior NUL. Win32 would stop at it and open a different, shorter path than the caller named.

PathTooLong

An ordinary path, or the fully qualified form it resolved to, did not fit the ordinary MAX_PATH limit including its terminator.

This limit is deliberate rather than incidental: it keeps behaviour independent of the host executable’s longPathAware manifest. Supply a fully qualified \\?\ path to enumerate a longer one.

NotFullyQualified

A \\?\ path was not fully qualified, so Win32 would not interpret it as the verbatim absolute path that prefix promises.

PathResolution

Windows could not resolve an ordinary path to its fully qualified form.

BufferCapacityUnrepresentable

The requested native buffer capacity, after clamping and alignment, cannot be passed to Win32 as a u32.

Trait Implementations

impl Clone for RequestFailure

fn clone(&self) -> RequestFailure

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RequestFailure

impl Debug for RequestFailure

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

Formats the value using the given formatter.

impl Eq for RequestFailure

impl Hash for RequestFailure

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 RequestFailure

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RequestFailure