Fungsi BCryptDestroyHash (bcrypt.h)

Fungsi BCryptDestroyHash menghancurkan hash atau objek Kode Autentikasi Pesan (MAC).

Sintaks

NTSTATUS BCryptDestroyHash(
  [in, out] BCRYPT_HASH_HANDLE hHash
);

Parameter

[in, out] hHash

Handel objek hash atau MAC untuk dihancurkan. Handel ini diperoleh dengan menggunakan fungsi BCryptCreateHash .

Nilai kembali

Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.

Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_INVALID_HANDLE	Handel algoritma dalam parameter hHash tidak valid.

Keterangan

Tergantung pada mode prosesor apa yang didukung penyedia, BCryptDestroyHash 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 hHash harus berasal dari handel algoritma yang dikembalikan oleh penyedia yang dibuka dengan menggunakan 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

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

BCryptCreateHash