Enum FullPathError 

#[non_exhaustive]
pub enum FullPathError {
    Win32(Win32Error),
    Unstable {
        attempts: usize,
    },
}

Why a full path could not be resolved.

This mirrors crate::final_path::FinalPathError deliberately: the two entries share a retry shape, so they share a failure vocabulary. An earlier revision returned a synthesized ERROR_INSUFFICIENT_BUFFER for the unstable case, which left a caller unable to tell that apart from the same code arriving from Windows, and made this entry the one place in the crate that invented a code Win32 had not produced.

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.

Win32(Win32Error)

Windows refused the call, with the raw code unaltered.

Unstable

The required size kept changing, so the retry was abandoned.

A path does not normally grow between two calls a microsecond apart, so this means something pathological rather than a transient. It is reported rather than looped on, because spinning here would hang the worker that a consumer moved this call onto in the first place.

Fields

attempts: usize

How many attempts were made before giving up.

Trait Implementations

impl Debug for FullPathError

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

Formats the value using the given formatter.

impl Display for FullPathError

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

Formats the value using the given formatter.

impl Error for FullPathError

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 FullPathError

fn from(error: Win32Error) -> Self

Converts to this type from the input type.