KeyChain.GetCertificateChain(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 die X509Certificate Kette für den 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 zu Ausnahmen in #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[]Parameter
- context
- Context
- alias
- String
Der Alias der gewünschten Zertifikatkette, 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 die X509Certificate Kette für den 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 zu Ausnahmen in #getPrivateKey).
<strong>Hinweis:</strong> Wenn beim Installieren des Alias explizit eine Zertifikatkette angegeben wurde, gibt diese Methode diese Kette zurück. Wenn nur das Clientzertifikat zur Installationszeit angegeben wurde, versucht diese Methode, eine Zertifikatkette mit allen verfügbaren Vertrauensankern (vorinstalliert und vom Benutzer hinzugefügt) zu erstellen.
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 aus dem Hauptthread zerstört werden können, ist es sicherer, sich auf einen langlebigen Kontext wie einen zurückzugebenden Context#getApplicationContext()Kontext zu verlassen.
Falls der Aufrufer einen Alias angibt, für den keine Genehmigung vorhanden ist, muss er erneut aufgerufen #choosePrivateKeyAlias werden. Weitere Informationen zur Bewältigung dieses Szenarios finden Sie unter .See #getPrivateKey for more details on coping with this scenario.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.