KeyChain.GetCertificateChain(Context, String) 方法

定義

命名空間:

Android.Security

組件:

Mono.Android.dll

X509Certificate傳回所要求別名的鏈結，如果別名不存在，或呼叫端沒有存取別名的許可權，則傳回 null（請參閱 中的#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[]

屬性

RegisterAttribute

例外狀況

KeyChainException

如果別名有效，但存取別名時發生問題。

IllegalStateException

如果從主線程呼叫，則為 。

InterruptedException

備註

X509Certificate傳回所要求別名的鏈結，如果別名不存在，或呼叫端沒有存取別名的許可權，則傳回 null（請參閱 中的#getPrivateKey例外狀況注意事項）。

<strong>Note：</strong> 如果已在安裝別名時明確指定憑證鏈結，這個方法會傳回該鏈結。 如果只在安裝時間指定客戶端憑證，這個方法會嘗試使用所有可用的信任錨點來建置憑證鏈結（預安裝並新增使用者）。

這個方法可能會在等候另一個進程的連線時封鎖，而且絕不能從主線程呼叫。

由於 Activity 和 Service 內容是短期的，而且可以隨時從主線程終結，因此依賴長期內容更安全，例如從 Context#getApplicationContext()傳回的內容。

如果呼叫端指定其缺少授與的別名，則必須再次呼叫 #choosePrivateKeyAlias 。 如需處理此案例的詳細資訊，請參閱 #getPrivateKey 。

的 android.security.KeyChain.getCertificateChain(android.content.Context, java.lang.String)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。