Enum ElevateError 

#[non_exhaustive]
pub enum ElevateError {
    Win32 {
        operation: &'static str,
        source: Error,
    },
    PrivilegeNotAssigned(&'static str),
    ProcessNotFound(String),
    ServiceFailed {
        name: String,
    },
    ServiceTimeout {
        name: String,
        seconds: u64,
    },
    SessionZeroNotSupported,
    NoInteractiveSession,
    Io(Error),
    MissingExePath,
    InvalidTokenBuffer,
}

The central error type for all privilege elevation and Windows security operations.

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

A raw Win32 subsystem call failed.

Fields

operation: &'static str

Name of the Win32 function that failed.

source: Error

Underlying Windows error code and message.

PrivilegeNotAssigned(&'static str)

A required Windows privilege could not be enabled.

ProcessNotFound(String)

A required genuine Windows SYSTEM process was not found.

ServiceFailed

A Windows service failed to start or entered a failed state.

Fields

name: String

Name of the target service.

ServiceTimeout

Waiting for a service to reach running state timed out.

Fields

name: String

Name of the target service.

seconds: u64

Elapsed time before giving up.

SessionZeroNotSupported

Caller is running in Session 0 (non-interactive service context).

NoInteractiveSession

No active interactive session with a logged-on user was found.

Io(Error)

An I/O error occurred during path resolution or execution.

MissingExePath

Executable path was not provided prior to launch.

InvalidTokenBuffer

A query to token information returned corrupted or out-of-bounds data.

Trait Implementations

impl Debug for ElevateError

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

Formats the value using the given formatter.

impl Display for ElevateError

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

Formats the value using the given formatter.

impl Error for ElevateError

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 ElevateError

fn from(source: Error) -> Self

Converts to this type from the input type.