KeyChain.GetCertificateChain(Context, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne la X509Certificate
chaîne de l’alias demandé, ou null si l’alias n’existe pas ou si l’appelant n’a pas l’autorisation d’y accéder (voir la remarque sur les exceptions dans #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[]
Paramètres
- context
- Context
- alias
- String
Alias de la chaîne de certificats souhaitée, généralement retourné via KeyChainAliasCallback#alias
.
Retours
- Attributs
Exceptions
si l’alias était valide, mais qu’il y avait un problème d’accès.
s’il est appelé à partir du thread principal.
Remarques
Retourne la X509Certificate
chaîne de l’alias demandé, ou null si l’alias n’existe pas ou si l’appelant n’a pas l’autorisation d’y accéder (voir la remarque sur les exceptions dans #getPrivateKey
).
<>strong Remarque :</strong> Si une chaîne de certificats a été spécifiée explicitement lors de l’installation de l’alias, cette méthode retourne cette chaîne. Si seul le certificat client a été spécifié au moment de l’installation, cette méthode tente de créer une chaîne de certificats à l’aide de toutes les ancres d’approbation disponibles (préinstallées et ajoutées par l’utilisateur).
Cette méthode peut bloquer lors de l’attente d’une connexion à un autre processus et ne doit jamais être appelée à partir du thread principal.
Comme Activity
et Service
les contextes sont de courte durée et peuvent être détruits à tout moment à partir du thread principal, il est plus sûr de s’appuyer sur un contexte de longue durée tel qu’un contexte retourné par Context#getApplicationContext()
.
Si l’appelant spécifie un alias pour lequel il n’a pas d’octroi, il doit appeler #choosePrivateKeyAlias
à nouveau. Pour plus d’informations sur la gestion de ce scénario, consultez #getPrivateKey
cette rubrique.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.