Fungsi BCryptFinalizeKeyPair (bcrypt.h)
Fungsi BCryptFinalizeKeyPair menyelesaikan pasangan kunci publik/privat. Kunci tidak dapat digunakan sampai fungsi ini dipanggil. Setelah fungsi ini dipanggil, fungsi BCryptSetProperty tidak dapat lagi digunakan untuk kunci ini.
Sintaks
NTSTATUS BCryptFinalizeKeyPair(
[in, out] BCRYPT_KEY_HANDLE hKey,
[in] ULONG dwFlags
);
Parameter
[in, out] hKey
Handel kunci untuk diselesaikan. Handel ini diperoleh dengan memanggil fungsi BCryptGenerateKeyPair .
[in] dwFlags
Sekumpulan bendera yang mengubah perilaku fungsi ini. Tidak ada bendera yang saat ini ditentukan, jadi parameter ini harus nol.
Menampilkan nilai
Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.
Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.
| Menampilkan kode | Deskripsi |
|---|---|
|
Fungsi berhasil. |
|
Handel kunci dalam parameter hKey tidak valid. |
|
Satu atau beberapa parameter tidak valid. |
|
Penyedia yang ditentukan tidak mendukung enkripsi kunci asimetris. |
Keterangan
Bergantung pada mode prosesor apa yang didukung penyedia, BCryptFinalizeKeyPair 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 hKey harus berasal dari handel algoritma yang dikembalikan oleh penyedia yang dibuka dengan bendera BCRYPT_PROV_DISPATCH .
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
| 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 |