Enum DeviceApprovalError 

#[non_exhaustive]
pub enum DeviceApprovalError {
    UnknownUserCode,
    Expired,
    NotPending,
    RateLimited,
    Storage(StorageError),
}

Rejections for the host-driven verification-UI actions (AuthorizationServer::approve_device / AuthorizationServer::deny_device). These are NOT wire errors: the RFC leaves the verification interaction to the implementation, and the host renders these however its UI wants.

#[non_exhaustive], for the reason lib.rs gives for re-exporting it at all: a host’s verification UI is expected to MATCH on this, so a later release that has a new way to refuse an entered code must be able to say so without that being a semver-major change for every host. Every other host-facing failure enum in this crate carries the same attribute (crate::registration::RegistrationFailure, crate::events::ClientAuthFailure, crate::consent::AuthenticationRequirement); this one was the exception, and there was no argument for the exception.

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.

UnknownUserCode

No live grant matches the entered code.

Expired

The grant existed but its lifetime has passed.

NotPending

The grant was already approved or denied.

RateLimited

The host’s own crate::events::RateLimiter refused the attempt before the code was looked up at all. RFC 8628 section 5.1 makes throttling user-code entry a REQUIREMENT of the deployment, not an optimisation, so this is a first-class answer and not an error.

Storage(StorageError)

The storage seam failed.

Trait Implementations

impl Clone for DeviceApprovalError

fn clone(&self) -> DeviceApprovalError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceApprovalError

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

Formats the value using the given formatter.

impl Display for DeviceApprovalError

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

Formats the value using the given formatter.

impl Eq for DeviceApprovalError

impl Error for DeviceApprovalError

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 PartialEq for DeviceApprovalError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DeviceApprovalError