Enum Error 

#[non_exhaustive]
pub enum Error {
    WrongPassword,
    NoEntropy,
    UnsupportedHandler(Box<[u8]>),
    MismatchedCryptFilters,
    MissingCryptFilter(Box<[u8]>),
    MalformedEncryptDict(&'static str),
    CipherKeyLength {
        cipher: &'static str,
        len: usize,
    },
}

What went wrong building a security handler.

The C++ collapses every one of these into a single “password error” at the parser boundary; splitting them changes no document’s fate but lets a caller tell “this needs a password” from “we cannot do this document’s cryptography”.

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.

WrongPassword

The password is neither the user nor the owner password.

NoEntropy

The operating system’s cryptographic generator is unavailable, so no file key can be minted. Raised only when creating an encrypted file; opening one needs no randomness.

UnsupportedHandler(Box<[u8]>)

/Filter names a handler other than /Standard. Public-key handlers (/Adobe.PubSec) land here.

MismatchedCryptFilters

[oracle-bug] Never constructed. §7.6.5 table 20 makes /StmF and /StrF independent, so a pair naming different crypt filters is conformant and this crate resolves each class separately. The variant is kept because it is a public enum member and removing it is a breaking change no caller gains from; nothing produces it.

MissingCryptFilter(Box<[u8]>)

The named crypt filter is not a key in /CF. An empty name is §7.6.5’s /Identity default rather than an error.

MalformedEncryptDict(&'static str)

The dictionary is structurally unusable.

CipherKeyLength

The resolved key length is one this cipher does not accept.

Fields

cipher: &'static str

The cipher that rejected the length.

len: usize

The length in bytes.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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

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

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Error