Fungsi CryptDestroyHash (wincrypt.h)
Untuk membantu memastikan keamanan, sebaiknya objek hash dihancurkan setelah digunakan.
Sintaks
BOOL CryptDestroyHash(
[in] HCRYPTHASH hHash
);
Parameter
[in] hHash
Handel objek hash yang akan dihancurkan.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.
Kode kesalahan yang diawali oleh "NTE" dihasilkan oleh penyedia layanan kriptografi tertentu (CSP) yang Anda gunakan. Beberapa kemungkinan kode kesalahan mengikuti.
Menampilkan kode | Deskripsi |
---|---|
|
Objek hash yang ditentukan oleh hHash saat ini sedang digunakan dan tidak dapat dihancurkan. |
|
Parameter hHash menentukan handel yang tidak valid. |
|
Parameter hHash berisi nilai yang tidak valid. |
|
Handel hHash menentukan algoritma yang tidak didukung CSP ini. |
|
Objek hash yang ditentukan oleh parameter hHash tidak valid. |
|
Konteks CSP yang ditentukan ketika objek hash dibuat tidak dapat ditemukan. |
Keterangan
Ketika objek hash dihancurkan, banyak CSP menimpa memori di CSP tempat objek hash ditahan. Memori CSP kemudian dibebaskan.
Harus ada korespondensi satu-ke-satu antara panggilan ke CryptCreateHash dan CryptDestroyHash.
Semua objek hash yang telah dibuat dengan menggunakan CSP tertentu harus dihancurkan sebelum handel CSP dirilis dengan fungsi CryptReleaseContext .
Contoh
Untuk contoh yang menggunakan fungsi CryptDestroyHash , lihat Contoh Program C: Membuat dan Hashing Kunci Sesi.
Persyaratan
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | wincrypt.h |
Pustaka | Advapi32.lib |
DLL | Advapi32.dll |