语言

KeyStoreException 类

定义

包含有关在生成或使用密钥时密钥存储/KeyMint 层故障的信息的异常。

[Android.Runtime.Register("android/security/KeyStoreException", ApiSince=33, DoNotGenerateAcw=true)]
public class KeyStoreException : Java.Lang.Exception
[<Android.Runtime.Register("android/security/KeyStoreException", ApiSince=33, DoNotGenerateAcw=true)>]
type KeyStoreException = class
    inherit Exception
继承
特性

注解

包含有关在生成或使用密钥时密钥存储/KeyMint 层故障的信息的异常。

公共错误代码指示错误的原因,方法指示它是系统/密钥问题,以及重新尝试操作(具有相同密钥或新密钥)是否可能会成功。

Java文档android.security.KeyStoreException。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

构造函数

名称 说明
KeyStoreException(IntPtr, JniHandleOwnership)

创建表示现有Java对象的托管实例。

字段

名称 说明
ErrorAttestationChallengeTooLarge
已过时.

指定的证明质询太大。

ErrorAttestationKeysUnavailable
已过时.

没有可用于证明的密钥。

ErrorIdAttestationFailure
已过时.

与在证明记录中包含设备标识符相关的错误。

ErrorIncorrectUsage
已过时.

调用方尝试使用的功能与用于生成密钥的参数不兼容。

ErrorInternalSystemError
已过时.

内部系统错误 - 请参阅 #isTransientFailure() 确定重新尝试操作是否可能会产生不同的结果。

ErrorKeyCorrupted
已过时.

密钥已损坏,无法恢复。

ErrorKeyDoesNotExist
已过时.

操作引用的键不存在。

ErrorKeymintFailure
已过时.

KeyMint 层中的常规错误。

ErrorKeyNotTemporallyValid
已过时.

密钥当前无效:已过期或将来有效。

ErrorKeyOperationExpired
已过时.

调用方一直使用的加密对象保留对已疏散的 KeyMint 操作的引用(可能是由于其他并发操作发生)。

ErrorKeystoreFailure
已过时.

密钥存储层中的失败。

ErrorKeystoreUninitialized
已过时.

load()指示尚未在密钥存储实例上调用,或者尝试生成授权绑定密钥,而用户尚未设置锁屏知识因子(LHP)。

ErrorOther
已过时.

此错误代码用于映射调用方不知道的错误。

ErrorPermissionDenied
已过时.

调用方已请求密钥参数或操作,这些参数仅适用于系统或特权应用。

ErrorTooManyKeys
已过时.

调用方具有过多的密钥存储密钥,因此不允许创建新密钥。

ErrorUnimplemented
已过时.

调用方尝试使用的功能不是由基础 KeyMint 实现实现的。

ErrorUserAuthenticationRequired
已过时.

指示无法使用该密钥,因为用户首先需要进行身份验证。

is_generated

true 如果此实例的运行时类型完全相同 Throwable,则为 ;否则为 false。

(继承自 Throwable)
RetryAfterNextReboot
已过时.

当设备下载软件更新并在下次重新启动时重新尝试导致此错误的操作。

RetryNever
已过时.

切勿重新尝试导致此错误的操作,因为它是永久性错误。

RetryWhenConnectivityAvailable
已过时.

重新尝试在设备重新获得连接时导致此错误的操作。

RetryWithExponentialBackoff
已过时.

重新尝试导致此错误的操作,并出现指数退避延迟。

属性

名称 说明
Cause

返回此可引发的原因,或者 null 原因不存在或未知。

(继承自 Throwable)
Class

获取此可引发的运行时类。

(继承自 Throwable)
Handle

基础 Android 实例的句柄。

(继承自 Throwable)
IsSystemError

指示与 Keystore/KeyMint 实现而不是特定密钥相关的错误。

IsTransientFailure

如果失败是暂时性故障,则返回 true,即,在后期再次执行相同操作可能会成功。

JavaStackTrace

获取从可引发结果捕获的Java堆栈跟踪。

(继承自 JavaException)
JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Throwable)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaException)
JniPeerMembers

获取用于访问此Java绑定成员的 JNI 元数据。

LocalizedMessage

创建此可引发的本地化说明。

(继承自 Throwable)
Message

返回此可引发的详细信息消息字符串。

(继承自 Throwable)
NumericErrorCode

返回类导出的错误代码之一。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Throwable)
RetryPolicy

返回暂时性故障的重新尝试策略。

StackTrace

获取此可引发的堆栈跟踪的字符串表示形式。

(继承自 Throwable)
ThresholdClass

获取用于虚拟方法调度的 Java 类。

ThresholdType

获取声明此Java绑定的托管类型。

方法

名称 说明
AddSuppressed(Throwable)

将指定的异常追加到取消的异常,以便传递此异常。

(继承自 Throwable)
Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaException)
Dispose()

释放此Java对等方持有的资源。

(继承自 Throwable)
Dispose(Boolean)

释放或终结此Java对等时由运行时调用。 实现 Throwable 不执行任何操作。

(继承自 Throwable)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaException)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaException)
FillInStackTrace()

填充执行堆栈跟踪。

(继承自 Throwable)
GetHashCode()

返回对象的哈希代码值。

(继承自 JavaException)
GetStackTrace()

提供对打印的 #printStackTrace()堆栈跟踪信息的编程访问。

(继承自 Throwable)
GetSuppressed()

返回一个数组,其中包含禁止显示的所有异常,通常是由 try-with-resources 语句为了传递此异常。

(继承自 Throwable)
InitCause(Throwable)

初始化此可引发到指定值 的原因 。

(继承自 Throwable)
PrintStackTrace()

打印此可引发结果及其回溯到标准错误流。

(继承自 Throwable)
PrintStackTrace(PrintStream)

打印此可引发的输出及其回溯到指定的打印流。

(继承自 Throwable)
PrintStackTrace(PrintWriter)

打印此可引发结果及其回溯到指定的打印编写器。

(继承自 Throwable)
RequiresUserAuthentication()

指示故障是否由设备锁定所致。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Throwable)
SetJavaStackTrace(JniObjectReference)

从可引发的堆栈跟踪刷新捕获的Java堆栈跟踪。

(继承自 JavaException)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaException)
SetStackTrace(StackTraceElement[])

设置将由相关方法返回 #getStackTrace() 和打印 #printStackTrace() 的堆栈跟踪元素。

(继承自 Throwable)
ToString()

将此值转换为字符串。

(继承自 Throwable)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Throwable)

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaException)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaException)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaException)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaException)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaException)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaException)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于