Fungsi CryptDestroyKey (wincrypt.h)
Jika handel mengacu pada kunci sesi, atau ke kunci publik yang telah diimpor ke penyedia layanan kriptografi (CSP) melalui CryptImportKey, fungsi ini menghancurkan kunci dan membebaskan memori yang digunakan kunci. Banyak CSP menimpa memori tempat kunci ditahan sebelum membebaskannya. Namun, pasangan kunci publik/privat yang mendasar tidak dihancurkan oleh fungsi ini. Hanya handel yang dihancurkan.
Sintaks
BOOL CryptDestroyKey(
[in] HCRYPTKEY hKey
);
Parameter
[in] hKey
Handel kunci yang akan dihancurkan.
Nilai kembali
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 CSP tertentu yang digunakan. Beberapa kemungkinan kode kesalahan tercantum dalam tabel berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Objek kunci yang ditentukan oleh hKey saat ini sedang digunakan dan tidak dapat dihancurkan. |
|
Parameter hKey menentukan handel yang tidak valid. |
|
Parameter hKey berisi nilai yang tidak valid. |
|
Parameter hKey tidak berisi handel yang valid ke kunci. |
|
Konteks CSP yang ditentukan ketika kunci dibuat tidak dapat ditemukan. |
Keterangan
Kunci mengambil ruang memori sistem operasi dan ruang memori CSP. Beberapa CSP diimplementasikan dalam perangkat keras dengan sumber daya memori terbatas. Aplikasi harus menghancurkan semua kunci dengan fungsi CryptDestroyKey ketika selesai dengannya.
Semua handel kunci yang telah dibuat atau diimpor dengan menggunakan CSP tertentu harus dihancurkan sebelum handel CSP dirilis dengan fungsi CryptReleaseContext .
Contoh
Untuk contoh yang menggunakan fungsi CryptDestroyKey , 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk