Fungsi BCryptSignHash (bcrypt.h)
Fungsi BCryptSignHash
Sintaksis
NTSTATUS BCryptSignHash(
[in] BCRYPT_KEY_HANDLE hKey,
[in, optional] VOID *pPaddingInfo,
[in] PUCHAR pbInput,
[in] ULONG cbInput,
[out] PUCHAR pbOutput,
[in] ULONG cbOutput,
[out] ULONG *pcbResult,
[in] ULONG dwFlags
);
Parameter
[in] hKey
Handel kunci yang digunakan untuk menandatangani hash.
[in, optional] pPaddingInfo
Penunjuk ke struktur yang berisi informasi padding. Jenis struktur aktual yang dituju parameter ini bergantung pada nilai parameter
[in] pbInput
Penunjuk ke buffer yang berisi nilai hash untuk ditandatangani. Parameter cbInput
[in] cbInput
Jumlah byte dalam pbInput buffer untuk ditandatangani.
[out] pbOutput
Alamat buffer untuk menerima tanda tangan yang dihasilkan oleh fungsi ini. Parameter
Jika parameter ini
[in] cbOutput
Ukurannya, dalam byte, dari pbOutput buffer. Parameter ini diabaikan jika parameter pbOutput
[out] pcbResult
Pointer ke variabel ULONG
Jika pbOutputnull, ini menerima ukuran, dalam byte, diperlukan untuk tanda tangan.
[in] dwFlags
Sekumpulan bendera yang mengubah perilaku fungsi ini. Set bendera yang diizinkan tergantung pada jenis kunci yang ditentukan oleh parameter
Ini bisa menjadi salah satu nilai berikut.
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. |
|
Handel kunci yang ditentukan oleh parameter |
|
Penyedia algoritma yang digunakan untuk membuat handel kunci yang ditentukan oleh parameter |
|
Terjadi kegagalan alokasi memori. |
|
Ukuran memori yang ditentukan oleh parameter cbOutput tidak cukup besar untuk menahan tanda tangan. |
Komentar
Fungsi ini akan mengenkripsi nilai hash dengan kunci yang ditentukan untuk membuat tanda tangan.
Untuk kemudian memverifikasi bahwa tanda tangan valid, panggil fungsi
Bergantung pada mode prosesor apa yang didukung penyedia, BCryptSignHash 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 |