KeyChain.GetPrivateKey(Context, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt den PrivateKey angeforderten Alias oder NULL zurück, wenn der Alias nicht vorhanden ist oder der Aufrufer keine Berechtigung für den Zugriff darauf hat (siehe Hinweis unten).
[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.IPrivateKey
Parameter
- context
- Context
- alias
- String
Der Alias des gewünschten privaten Schlüssels, der in der Regel über KeyChainAliasCallback#alias.
Gibt zurück
- Attribute
Ausnahmen
wenn der Alias gültig war, aber ein Problem beim Zugriff darauf aufgetreten ist.
wenn vom Hauptthread aufgerufen wird.
Hinweise
Gibt den PrivateKey angeforderten Alias oder NULL zurück, wenn der Alias nicht vorhanden ist oder der Aufrufer keine Berechtigung für den Zugriff darauf hat (siehe Hinweis unten).
Diese Methode kann während des Wartens auf eine Verbindung mit einem anderen Prozess blockiert werden und darf niemals aus dem Hauptthread aufgerufen werden.
Da Activity und Service Kontexte kurzlebig sind und jederzeit vom Hauptthread zerstört werden können, ist es sicherer, sich auf einen langlebigen Kontext wie einen zurückzugebenden Context#getApplicationContext()Kontext zu verlassen.
Wenn der Aufrufer einen gültigen Alias bereitstellt, für den er keinen Zugriff gewährt hat, muss der Aufrufer erneut aufgerufen werden #choosePrivateKeyAlias , um einen anderen gültigen Alias abzurufen oder einen Zugriff auf denselben Alias zu gewähren.
Wenn ein Schlüssel, der dem angegebenen Alias zugeordnet ist, auf Android-Versionen vor Q nicht verfügbar ist, löst die Methode eine KeyChainException statt null zurück. Wenn die Ursache der Ausnahme (wie durch Aufrufe KeyChainException.getCause()abgerufen) ein Auslöser vom Typ IllegalStateException ist, fehlt dem Anrufer eine Gewährung für den Zugriff auf den Schlüssel und die Zertifikate, die diesem Alias zugeordnet sind.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.