KeyChain.GetPrivateKey(Context, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
要求されたエイリアスの PrivateKey を返します。エイリアスが存在しない場合、または呼び出し元にアクセス許可がない場合は null を返します (以下の例外に関する注意事項を参照)。
[Android.Runtime.Register("getPrivateKey", "(Landroid/content/Context;Ljava/lang/String;)Ljava/security/PrivateKey;", "")]
public static Java.Security.IPrivateKey? GetPrivateKey(Android.Content.Context context, string alias);[<Android.Runtime.Register("getPrivateKey", "(Landroid/content/Context;Ljava/lang/String;)Ljava/security/PrivateKey;", "")>]
static member GetPrivateKey : Android.Content.Context * string -> Java.Security.IPrivateKeyパラメーター
- context
- Context
- alias
- String
通常、 KeyChainAliasCallback#alias経由で返される目的の秘密キーのエイリアス。
返品
- 属性
例外
エイリアスが有効であったが、アクセス中に何らかの問題が発生した場合。
メイン スレッドから呼び出された場合。
注釈
要求されたエイリアスの PrivateKey を返します。エイリアスが存在しない場合、または呼び出し元にアクセス許可がない場合は null を返します (以下の例外に関する注意事項を参照)。
このメソッドは、別のプロセスへの接続を待機している間にブロックする可能性があり、メイン スレッドから呼び出してはなりません。
ActivityコンテキストとServiceコンテキストは有効期間が短く、メイン スレッドからいつでも破棄できるため、Context#getApplicationContext()から返されるコンテキストなど、有効期間の長いコンテキストに依存する方が安全です。
呼び出し元がアクセスを許可されていない有効なエイリアスを指定した場合、呼び出し元は、別の有効なエイリアスまたは同じエイリアスにアクセスするための許可を取得するために、 #choosePrivateKeyAlias をもう一度呼び出す必要があります。
Q より前の Android バージョンでは、指定したエイリアスに関連付けられているキーが使用できない場合、メソッドは null を返すのではなく、 KeyChainException をスローします。 例外の原因 ( KeyChainException.getCause() 呼び出しによって取得された) が IllegalStateException 型のスロー可能な場合、呼び出し元には、このエイリアスに関連付けられているキーと証明書にアクセスするための許可がありません。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。