Fungsi BCryptImportKey (bcrypt.h)
Fungsi BCryptImportKey mengimpor kunci konten dari BLOB kunci. Fungsi BCryptImportKeyPair digunakan untuk mengimpor pasangan kunci publik/privat.
Sintaks
NTSTATUS BCryptImportKey(
[in] BCRYPT_ALG_HANDLE hAlgorithm,
[in, optional] BCRYPT_KEY_HANDLE hImportKey,
[in] LPCWSTR pszBlobType,
[out] BCRYPT_KEY_HANDLE *phKey,
[out, optional] PUCHAR pbKeyObject,
[in] ULONG cbKeyObject,
[in] PUCHAR pbInput,
[in] ULONG cbInput,
[in] ULONG dwFlags
);
Parameter
[in] hAlgorithm
Handel penyedia algoritma untuk mengimpor kunci. Handel ini diperoleh dengan memanggil fungsi BCryptOpenAlgorithmProvider .
[in, optional] hImportKey
Handel kunci enkripsi kunci yang diperlukan untuk membuka bungkus BLOB kunci dalam parameter pbInput .
Windows Server 2008 dan Windows Vista: Parameter ini tidak digunakan dan harus diatur ke NULL.
[in] pszBlobType
String Unicode yang dihentikan null yang berisi pengidentifikasi yang menentukan jenis BLOB yang terkandung dalam buffer pbInput . Ini bisa menjadi salah satu nilai berikut.
Nilai | Makna |
---|---|
|
Impor kunci konten dari BLOB kunci yang dibungkus kunci AES. Parameter hImportKey harus mereferensikan penunjuk BCRYPT_KEY_HANDLE yang valid ke kunci enkripsi kunci.
Windows Server 2008 dan Windows Vista: Jenis BLOB ini tidak didukung. |
|
Mengimpor kunci konten dari BLOB data. Parameter pbInput adalah penunjuk ke struktur BCRYPT_KEY_DATA_BLOB_HEADER segera diikuti oleh BLOB kunci. |
|
Impor BLOB kunci konten dalam format yang khusus untuk satu CSP. BLOB buram tidak dapat ditransfer dan harus diimpor dengan menggunakan CSP yang sama yang menghasilkan BLOB. BLOB buram hanya dimaksudkan untuk digunakan untuk transfer kunci antarproseksi dan tidak cocok untuk dipertahankan dan dibaca di seluruh versi penyedia. |
[out] phKey
Penunjuk ke BCRYPT_KEY_HANDLE yang menerima handel kunci yang diimpor. Handel ini digunakan dalam fungsi berikutnya yang memerlukan kunci, seperti BCryptEncrypt. Handel ini harus dirilis ketika tidak lagi diperlukan dengan meneruskannya ke fungsi BCryptDestroyKey .
[out, optional] pbKeyObject
Penunjuk ke buffer yang menerima objek kunci yang diimpor. Parameter cbKeyObject berisi ukuran buffer ini. Ukuran buffer yang diperlukan dapat diperoleh dengan memanggil fungsi BCryptGetProperty untuk mendapatkan properti BCRYPT_OBJECT_LENGTH . Ini akan memberikan ukuran objek kunci untuk algoritma yang ditentukan.
Memori ini hanya dapat dikosongkan setelah handel kunci phKey dihancurkan.
[in] cbKeyObject
Ukuran, dalam byte, dari buffer pbKeyObject .
[in] pbInput
Alamat buffer yang berisi BLOB kunci untuk diimpor. Parameter cbInput berisi ukuran buffer ini. Parameter pszBlobType menentukan jenis BLOB kunci yang dikandung buffer ini.
[in] cbInput
Ukuran, dalam byte, dari buffer pbInput .
[in] dwFlags
Sekumpulan bendera yang mengubah perilaku fungsi ini. Tidak ada bendera yang saat ini ditentukan, jadi parameter ini harus nol.
Nilai kembali
Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.
Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Fungsi berhasil. |
|
Ukuran objek kunci yang ditentukan oleh parameter cbKeyObject tidak cukup besar untuk menahan objek kunci. |
|
Handel algoritma dalam parameter hAlgorithm tidak valid. |
|
Satu atau beberapa parameter tidak valid. |
|
Penyedia algoritma yang ditentukan oleh parameter hAlgorithm tidak mendukung jenis BLOB yang ditentukan oleh parameter pszBlobType . |
Keterangan
Bergantung pada mode prosesor apa yang didukung penyedia, BCryptImportKey dapat dipanggil baik dari mode pengguna atau mode kernel. Pemanggil mode kernel dapat mengeksekusi baik di PASSIVE_LEVEL IRQL atau DISPATCH_LEVEL IRQL. Jika tingkat IRQL saat ini DISPATCH_LEVEL, handel yang disediakan dalam parameter hAlgorithm harus dibuka dengan menggunakan bendera BCRYPT_PROV_DISPATCH , dan setiap pointer yang diteruskan ke fungsi BCryptImportKey harus mengacu pada memori yang tidak di-patahkan (atau dikunci).
Untuk memanggil fungsi ini dalam mode kernel, gunakan Cng.lib, yang merupakan bagian dari Driver Development Kit (DDK). Windows Server 2008 dan Windows Vista: Untuk memanggil fungsi ini dalam mode kernel, gunakan Ksecdd.lib.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2008 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | bcrypt.h |
Pustaka | Bcrypt.lib |
DLL | Bcrypt.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk