KeyChain.GetPrivateKey(Context, String) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
PrivateKey Mengembalikan untuk alias yang diminta, atau null jika alias tidak ada atau pemanggil tidak memiliki izin untuk mengaksesnya (lihat catatan tentang pengecualian di bawah).
[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.IPrivateKeyParameter
- context
- Context
- alias
- String
Alias kunci privat yang diinginkan, biasanya dikembalikan melalui KeyChainAliasCallback#alias.
Mengembalikan
- Atribut
Pengecualian
jika alias valid tetapi ada beberapa masalah saat mengaksesnya.
jika dipanggil dari utas utama.
Keterangan
PrivateKey Mengembalikan untuk alias yang diminta, atau null jika alias tidak ada atau pemanggil tidak memiliki izin untuk mengaksesnya (lihat catatan tentang pengecualian di bawah).
Metode ini dapat memblokir saat menunggu koneksi ke proses lain, dan tidak boleh dipanggil dari utas utama.
Karena Activity konteks dan Service berumur pendek dan dapat dihancurkan kapan saja dari utas utama, lebih aman untuk mengandalkan konteks berumur panjang seperti yang dikembalikan dari Context#getApplicationContext().
Jika pemanggil menyediakan alias yang valid yang tidak diberikan aksesnya, maka pemanggil harus memanggil #choosePrivateKeyAlias lagi untuk mendapatkan alias lain yang valid atau pemberian untuk mengakses alias yang sama.
Pada versi Android sebelum Q, ketika kunci yang terkait dengan alias yang ditentukan tidak tersedia, metode akan melemparkan KeyChainException daripada mengembalikan null. Jika penyebab pengecualian (seperti yang diperoleh dengan panggilan KeyChainException.getCause()) adalah jenis IllegalStateException yang dapat dilemparkan, pemanggil tidak memiliki hibah untuk mengakses kunci dan sertifikat yang terkait dengan alias ini.
Bagian dari halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Android Open Source Project dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Creative Commons 2.5 Lisensi Atribusi.