Enum Error 

pub enum Error {
    RequiresUpdate(RequireUpdateError),
    WinError(Error),
}

A comprehensive error type for WSL plugins.

This enum encapsulates two main error categories:

• Plugin-specific errors (RequireUpdateError).
• Errors originating from Windows APIs (WinError).

Variants

RequiresUpdate(RequireUpdateError)

Indicates that the current WSL version does not meet the required version.

WinError(Error)

Represents an error from Windows APIs.

Implementations

impl Error

pub const fn code(&self) -> HRESULT

Retrieves the error code as an HRESULT.

Returns

The error code wrapped in an HRESULT.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<Error> for Error

fn from(source: RequireUpdateError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: WinError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(value: Error) -> Self

Converts the Error enum into a WinError.

• Maps Error::RequiresUpdate to WSL_E_PLUGIN_REQUIRES_UPDATE.
• Maps Error::WinError directly to itself.

Returns

A WinError representing the error.

impl From<Error> for Error

fn from(value: ApiError) -> Self

Converts to this type from the input type.

impl From<Error> for HRESULT

fn from(value: Error) -> Self

Converts the Error enum into an HRESULT code.

• Maps Error::RequiresUpdate to WSL_E_PLUGIN_REQUIRES_UPDATE.
• Maps Error::WinError to its corresponding HRESULT code.

Returns

An HRESULT code representing the error.