Fungsi CryptReleaseContext (wincrypt.h)

Artikel
08/27/2023

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 CryptReleaseContext merilis handel penyedia layanan kriptografi (CSP) dan kontainer kunci. Pada setiap panggilan ke fungsi ini, jumlah referensi pada CSP dikurangi satu. Ketika jumlah referensi mencapai nol, konteks sepenuhnya dirilis dan tidak dapat lagi digunakan oleh fungsi apa pun dalam aplikasi.

Aplikasi memanggil fungsi ini setelah menyelesaikan penggunaan CSP. Setelah fungsi ini dipanggil, handel CSP yang dirilis tidak lagi valid. Fungsi ini tidak menghancurkan kontainer kunci atau pasangan kunci.

Sintaks

BOOL CryptReleaseContext(
  [in] HCRYPTPROV hProv,
  [in] DWORD      dwFlags
);

Parameter

[in] hProv

Menangani penyedia layanan kriptografi (CSP) yang dibuat oleh panggilan ke CryptAcquireContext.

[in] dwFlags

Dicadangkan untuk digunakan di masa mendatang dan harus nol. Jika dwFlags tidak diatur ke nol, fungsi ini mengembalikan FALSE tetapi CSP dirilis.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol (TRUE).

Jika fungsi gagal, nilai yang dikembalikan adalah nol (FALSE). Untuk informasi kesalahan yang diperluas, hubungi GetLastError. Beberapa kemungkinan kode kesalahan tercantum dalam tabel berikut.

Menampilkan kode	Deskripsi
ERROR_BUSY	Konteks CSP yang ditentukan oleh hProv saat ini sedang digunakan oleh proses lain.
ERROR_INVALID_HANDLE	Salah satu parameter menentukan handel yang tidak valid.
ERROR_INVALID_PARAMETER	Salah satu parameter berisi nilai yang tidak valid. Ini paling sering merupakan pointer yang tidak valid.
NTE_BAD_FLAGS	Parameter dwFlags bukan nol.
NTE_BAD_UID	Parameter hProv tidak berisi handel konteks yang valid.

Keterangan

Setelah fungsi ini dipanggil, sesi CSP selesai dan semua kunci sesi dan objek hash yang ada yang dibuat dengan menggunakan handel hProv tidak lagi valid. Dalam praktiknya, semua objek ini harus dihancurkan dengan panggilan ke CryptDestroyKey dan CryptDestroyHash sebelum CryptReleaseContext dipanggil.

Contoh

Untuk contoh yang menggunakan fungsi ini, lihat Contoh Program C: Membuat dan Hashing Kunci Sesi.

Persyaratan


Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	wincrypt.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll