Fungsi CryptDestroyHash (wincrypt.h)

  • Artikel
Penting API ini tidak digunakan lagi. Perangkat lunak baru dan yang sudah ada harus mulai menggunakan Cryptography Next Generation API. Microsoft dapat menghapus API ini dalam rilis mendatang.
 
Fungsi CryptDestroyHash menghancurkan objek hash yang direferensikan oleh parameter hHash . Setelah objek hash dihancurkan, objek tersebut tidak dapat digunakan lagi.

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
ERROR_BUSY
 Objek hash yang ditentukan oleh hHash saat ini sedang digunakan dan tidak dapat dihancurkan.
ERROR_INVALID_HANDLE
 Parameter hHash menentukan handel yang tidak valid.
ERROR_INVALID_PARAMETER
 Parameter hHash berisi nilai yang tidak valid.
NTE_BAD_ALGID
 Handel hHash menentukan algoritma yang tidak didukung CSP ini.
NTE_BAD_HASH
 Objek hash yang ditentukan oleh parameter hHash tidak valid.
NTE_BAD_UID
 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

Lihat juga

CryptCreateHash

CryptHashData

CryptSignHash

Fungsi Hash dan Tanda Tangan Digital