Konteks Penyedia Layanan Kriptografi

Fungsi CryptoAPI pertama yang dipanggil oleh aplikasi yang menggunakan API kriptografi apa pun adalah fungsi CryptAcquireContext . Fungsi ini mengembalikan handel ke CSP tertentu yang mencakup spesifikasi kontainer kunci tertentu dalam CSP. Kontainer kunci ini adalah kontainer kunci yang diminta secara khusus atau merupakan kontainer kunci default untuk pengguna yang saat ini masuk.

CryptAcquireContext juga dapat membuat kontainer kunci baru. Untuk informasi selengkapnya, lihat Contoh Program C: Membuat Kontainer Kunci dan Menghasilkan Kunci dan Contoh Program C: Menggunakan CryptAcquireContext.

Penyedia layanan kriptografi (CSP) memiliki nama dan jenis. Misalnya, nama salah satu CSP yang saat ini dikirim dengan sistem operasi adalah Penyedia Kriptografi Dasar Microsoft. Ini adalah penyedia jenis PROV_RSA_FULL . Nama setiap penyedia unik; jenis penyedia tidak.

Ketika aplikasi memanggil CryptAcquireContext untuk mendapatkan handel CSP, aplikasi menentukan jenis penyedia dan, secara opsional, nama penyedia. Jika jenis dan nama ditentukan, fungsi memuat CSP dengan jenis penyedia dan nama penyedia yang cocok. Fungsi mengembalikan handel CSP yang menyediakan akses ke CSP dan ke kontainer kunci dalam CSP.

Ketika aplikasi memanggil CryptAcquireContext dan menentukan jenis penyedia tetapi tidak ada nama penyedia, fungsi mencari penyedia bernama, pertama-tama memeriksa daftar penyedia bernama default yang terkait dengan pengguna yang masuk dan, jika gagal, dari daftar penyedia bernama default yang terkait dengan komputer. Setelah nama penyedia ditentukan, fungsi CryptAcquireContext mencari CSP untuk penyedia tersebut, memuatnya, dan mengembalikan handelnya.

Setelah Anda selesai menggunakan handel CSP, lepaskan dengan memanggil fungsi CryptReleaseContext .