KeyChain.GetPrivateKey(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.
Renvoie l’alias PrivateKey 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 ci-dessous).
[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.IPrivateKeyParamètres
- context
- Context
- alias
- String
Alias de la clé privée 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
Renvoie l’alias PrivateKey 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 ci-dessous).
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 fournit un alias valide auquel il n’a pas accordé l’accès, l’appelant doit appeler #choosePrivateKeyAlias à nouveau pour obtenir un autre alias valide ou une autorisation d’accès au même alias.
Sur les versions Android antérieures à Q, lorsqu’une clé associée à l’alias spécifié n’est pas disponible, la méthode lève une KeyChainException valeur null au lieu de retourner la valeur Null. Si la cause de l’exception (telle qu’elle est obtenue par l’appel KeyChainException.getCause()) est un type IllegalStateException pouvant être levée, l’appelant n’a pas l’autorisation d’accéder à la clé et aux certificats associés à cet alias.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.