Fungsi BCryptGenerateSymmetricKey (bcrypt.h)
Fungsi BCryptGenerateSymmetricKey membuat objek kunci untuk digunakan dengan algoritma enkripsi kunci simetris dari kunci yang disediakan.
Sintaksis
NTSTATUS BCryptGenerateSymmetricKey(
[in, out] BCRYPT_ALG_HANDLE hAlgorithm,
[out] BCRYPT_KEY_HANDLE *phKey,
[out, optional] PUCHAR pbKeyObject,
[in] ULONG cbKeyObject,
[in] PUCHAR pbSecret,
[in] ULONG cbSecret,
[in] ULONG dwFlags
);
Parameter
[in, out] hAlgorithm
Handel penyedia algoritma yang dibuat dengan fungsi
[out] phKey
Penunjuk ke BCRYPT_KEY_HANDLE yang menerima handel kunci. 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. Parameter cbKeyObject
Memori ini hanya dapat dibebaskan setelah pegangan kunci phKey
Jika nilai parameter ini NULL dan nilai parameter cbKeyObject adalah nol, memori untuk objek kunci dialokasikan dan dibebaskan oleh fungsi ini.Windows 7: Fungsionalitas manajemen memori ini tersedia dimulai dengan Windows 7.
[in] cbKeyObject
Ukurannya, dalam byte, dari pbKeyObject buffer.
Jika nilai parameter ini nol dan nilai parameter pbKeyObjectNULL, memori untuk objek kunci dialokasikan dan dibebaskan oleh fungsi ini.Windows 7: Fungsionalitas manajemen memori ini tersedia dimulai dengan Windows 7.
[in] pbSecret
Penunjuk ke buffer yang berisi kunci untuk membuat objek kunci. Parameter cbSecret
[in] cbSecret
Ukurannya, dalam byte, dari pbSecret buffer.
[in] dwFlags
Sekumpulan bendera yang mengubah perilaku fungsi ini. Tidak ada bendera yang saat ini ditentukan, jadi parameter ini harus nol.
Mengembalikan nilai
Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.
Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.
Mengembalikan kode | Deskripsi |
---|---|
|
Fungsi berhasil. |
|
Ukuran objek kunci yang ditentukan oleh parameter |
|
Handel algoritma dalam parameter hAlgoritma |
|
Satu atau beberapa parameter tidak valid. |
Komentar
Bergantung pada mode prosesor apa yang didukung penyedia, BCryptGenerateSymmetricKey dapat dipanggil baik dari mode pengguna atau mode kernel. Pemanggil mode kernel dapat menjalankan baik di PASSIVE_LEVELIRQL atau IRQL DISPATCH_LEVEL. Jika tingkat IRQL saat ini
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
Syarat | Nilai |
---|---|
klien minimum yang didukung | Windows Vista [aplikasi desktop | Aplikasi UWP] |
server minimum yang didukung |
Windows Server 2008 [aplikasi desktop | Aplikasi UWP] |
Platform Target |
Windows |
Header |
bcrypt.h |
Pustaka |
Bcrypt.lib |
DLL |
Bcrypt.dll |