#[non_exhaustive]pub enum Error {
PlatformFailure(Box<dyn Error + Send + Sync>),
NoStorageAccess(Box<dyn Error + Send + Sync>),
NoEntry,
BadEncoding(Vec<u8>),
TooLong(String, u32),
Invalid(String, String),
Ambiguous(Vec<Box<Credential>>),
}
Expand description
Each variant of the Error
enum provides a summary of the error.
More details, if relevant, are contained in the associated value,
which may be platform-specific.
Because future releases may add variants to this enum, clients should always be prepared for that.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
PlatformFailure(Box<dyn Error + Send + Sync>)
This indicates runtime failure in the underlying platform storage system. The details of the failure can be retrieved from the attached platform error.
NoStorageAccess(Box<dyn Error + Send + Sync>)
This indicates that the underlying secure storage holding saved items could not be accessed. Typically this is because of access rules in the platform; for example, it might be that the credential store is locked. The underlying platform error will typically give the reason.
NoEntry
This indicates that there is no underlying credential entry in the platform for this entry. Either one was never set, or it was deleted.
BadEncoding(Vec<u8>)
This indicates that the retrieved password blob was not a UTF-8 string. The underlying bytes are available for examination in the attached value.
TooLong(String, u32)
This indicates that one of the entry’s credential attributes exceeded a length limit in the underlying platform. The attached values give the name of the attribute and the platform length limit that was exceeded.
Invalid(String, String)
This indicates that one of the entry’s required credential attributes was invalid. The attached value gives the name of the attribute and the reason it’s invalid.
Ambiguous(Vec<Box<Credential>>)
This indicates that there is more than one credential found in the store that matches the entry. Its value is a vector of the matching credentials.