Enum PathCaptureError 

#[non_exhaustive]
pub enum PathCaptureError {
    InteriorNul,
    CurrentDirectory(Win32Error),
    CurrentDirectoryUnstable {
        attempts: usize,
    },
}

Why a path could not be captured for a request.

The failures are the two a path can have at construction: it cannot be carried to Win32 as it is, or the current directory it is to be fixed to could not be read. The second mirrors crate::full_path::FullPathError, which shares the retry shape and so the vocabulary.

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.

InteriorNul

The path contains a NUL before its end. Win32 reads a path up to its first NUL, so it would act on a shorter path than the one named.

CurrentDirectory(Win32Error)

GetCurrentDirectoryW was refused, with the raw code unaltered.

CurrentDirectoryUnstable

The size of the current directory kept changing, so the retry was abandoned.

Fields

attempts: usize

How many attempts were made before giving up.

Trait Implementations

impl Debug for PathCaptureError

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

Formats the value using the given formatter.

impl Display for PathCaptureError

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

Formats the value using the given formatter.

impl Error for PathCaptureError

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.