Fungsi BCryptHash (bcrypt.h)

Melakukan komputasi hash tunggal. Ini adalah fungsi kenyamanan yang membungkus panggilan ke BCryptCreateHash, BCryptHashData, BCryptFinishHash, dan BCryptDestroyHash.

Sintaks

NTSTATUS BCryptHash(
  BCRYPT_ALG_HANDLE hAlgorithm,
  PUCHAR            pbSecret,
  ULONG             cbSecret,
  PUCHAR            pbInput,
  ULONG             cbInput,
  PUCHAR            pbOutput,
  ULONG             cbOutput
);

Parameter

hAlgorithm

Handel penyedia algoritma yang dibuat dengan menggunakan fungsi BCryptOpenAlgorithmProvider . Algoritma yang ditentukan ketika penyedia dibuat harus mendukung antarmuka hash.

pbSecret

Penunjuk ke buffer yang berisi kunci yang akan digunakan untuk hash atau MAC. Parameter cbSecret berisi ukuran buffer ini. Kunci ini hanya berlaku untuk algoritma hash yang dibuka oleh fungsi BCryptOpenAlgorithmProvider dengan menggunakan bendera BCRYPT_ALG_HANDLE_HMAC . Jika tidak, atur parameter ini ke NULL

cbSecret

Ukuran, dalam byte, dari penyangga pbSecret . Jika tidak ada kunci yang digunakan, atur parameter ini ke nol.

pbInput

Penunjuk ke buffer yang berisi data yang akan diproses. Parameter cbInput berisi jumlah byte dalam buffer ini. Fungsi ini tidak mengubah isi buffer ini.

cbInput

Jumlah byte dalam buffer pbInput .

pbOutput

Penunjuk ke buffer yang menerima nilai hash atau MAC. Parameter cbOutput berisi ukuran buffer ini.

cbOutput

Ukuran, dalam byte, dari buffer pbOutput . Ukuran ini harus sama persis dengan ukuran nilai hash atau MAC.

Ukurannya dapat diperoleh dengan memanggil fungsi BCryptGetProperty untuk mendapatkan properti BCRYPT_HASH_LENGTH . Ini akan memberikan ukuran nilai hash atau MAC untuk algoritma yang ditentukan.

Menampilkan nilai

Kode status yang menunjukkan keberhasilan atau kegagalan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2016 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	bcrypt.h
Pustaka	Bcrypt.lib
DLL	Bcrypt.dll