KeyChain.GetCertificateChain(Context, String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
回傳請求別名的鏈,若別名不存在或呼叫者無權限存取則回傳X509Certificate為空(詳見例外說明)。#getPrivateKey
[Android.Runtime.Register("getCertificateChain", "(Landroid/content/Context;Ljava/lang/String;)[Ljava/security/cert/X509Certificate;", "")]
public static Java.Security.Cert.X509Certificate[]? GetCertificateChain(Android.Content.Context context, string alias);
[<Android.Runtime.Register("getCertificateChain", "(Landroid/content/Context;Ljava/lang/String;)[Ljava/security/cert/X509Certificate;", "")>]
static member GetCertificateChain : Android.Content.Context * string -> Java.Security.Cert.X509Certificate[]
參數
- context
- Context
- alias
- String
所需憑證鏈的別名,通常透過 KeyChainAliasCallback#alias。
傳回
- 屬性
例外狀況
如果別名是有效的,但存取時有問題。
如果是從主串呼叫的話。
備註
回傳請求別名的鏈,若別名不存在或呼叫者無權限存取則回傳X509Certificate為空(詳見例外說明)。#getPrivateKey
<strong>Note:</strong> 如果安裝別名時明確指定了憑證鏈,此方法會回傳該鏈。 若安裝時僅指定客戶端憑證,此方法將嘗試利用所有可用的信任錨點(預裝與使用者新增)建立憑證鏈。
此方法可在等待連接至其他程序時阻塞,且絕不可從主執行緒呼叫。
由於 Activity 上下文 Service 壽命短暫且可隨時從主執行緒中刪除,較安全的做法是依賴長壽命上下文,例如從 Context#getApplicationContext()返回的上下文。
若呼叫者指定了未獲得授權的別名,必須再次呼叫 #choosePrivateKeyAlias 。 關於如何應對這種情況的更多細節,請參考。#getPrivateKey
Java 文件 android.security.KeyChain.getCertificateChain(android.content.Context, java.lang.String)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。