KeyChain.GetCertificateChain(Context, String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает цепочку 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
запрошенного псевдонима или null, если псевдоним не существует или вызывающий объект не имеет разрешения на доступ к нему (см. примечание об исключениях в #getPrivateKey
).
<strong>Note:</strong> , если цепочка сертификатов была явно указана при установке псевдонима, этот метод вернет эту цепочку. Если только сертификат клиента был указан во время установки, этот метод попытается создать цепочку сертификатов, используя все доступные привязки доверия (предварительно установленные и добавленные пользователем).
Этот метод может блокироваться во время ожидания подключения к другому процессу и никогда не вызываться из основного потока.
Так как Activity
и Service
контексты являются короткими и могут быть уничтожены в любое время из основного потока, безопаснее полагаться на долгосрочный контекст, такой как один возвращенный.Context#getApplicationContext()
Если вызывающий объект указывает псевдоним, для которого он не имеет гранта, он должен снова вызвать #choosePrivateKeyAlias
. Дополнительные #getPrivateKey
сведения о том, как справиться с этим сценарием.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.