PFN_CMSG_CNG_IMPORT_KEY_AGREE fungsi panggilan balik (wincrypt.h)
Fungsi panggilan balik PFN_CMSG_CNG_IMPORT_KEY_AGREE mendekripsi kunci enkripsi konten (CEK) yang ditujukan untuk penerima perjanjian kunci. PFN_CMSG_CNG_IMPORT_KEY_AGREE dapat diinstal dengan menggunakan API Kriptografi: Pengidentifikasi objek (OID) Generasi Berikutnya (CNG).
Sintaks
PFN_CMSG_CNG_IMPORT_KEY_AGREE PfnCmsgCngImportKeyAgree;
BOOL PfnCmsgCngImportKeyAgree(
[in, out] PCMSG_CNG_CONTENT_DECRYPT_INFO pCNGContentDecryptInfo,
[in] PCMSG_CTRL_KEY_AGREE_DECRYPT_PARA pKeyAgreeDecryptPara,
[in] DWORD dwFlags,
void *pvReserved
)
{...}
Parameter
[in, out] pCNGContentDecryptInfo
Penunjuk ke struktur CMSG_CNG_CONTENT_DECRYPT_INFO yang akan diperbarui dengan byte CEK yang didekripsi. Parameter ini berisi kunci yang digunakan untuk mendekripsi CEK. Parameter pKeyTransDecryptPara berikut berisi byte CEK yang akan didekripsi.
[in] pKeyAgreeDecryptPara
Penunjuk ke struktur CMSG_CTRL_KEY_AGREE_DECRYPT_PARA yang berisi informasi perjanjian utama yang diteruskan ke fungsi CryptMsgControl dalam kasus CMSG_CTRL_KEY_AGREE_DECRYPT .
Anggota EncryptedKey dari anggota pKeyAgree berisi byte CEK yang akan didekripsi. Karena struktur CMSG_CTRL_KEY_AGREE_DECRYPT_PARA mungkin berisi pilihan HCRYPTPROV , anggota hNCryptKey-nya tidak boleh digunakan untuk mendekripsi EncryptedKey. Sebagai gantinya, Anda harus menggunakan anggota hNCryptKey yang ditentukan dalam parameter pCNGContentDecryptInfo .
Fungsi ini tidak boleh memperbarui anggota struktur CMSG_CTRL_KEY_AGREE_DECRYPT_PARA .
[in] dwFlags
Parameter ini dicadangkan. Atur ke nol.
pvReserved
Parameter ini dicadangkan. Atur ke NULL.
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.
Jika fungsi panggilan balik ini tidak mendukung algoritma enkripsi kunci, fungsi tersebut harus mengembalikan FALSE dan memanggil SetLastError dengan ERROR_NOT_SUPPORTED.
Keterangan
Fungsi CryptMsgControl memanggil fungsi ini untuk operasi berikut yang ditentukan oleh parameter dwCtrlType :
CMSG_CTRL_KEY_AGREE_DECRYPT Anda dapat menggunakan Fungsi Dukungan OID untuk menyebarkan fungsi panggilan balik ini. Wincrypt.h mendefinisikan konstanta berikut untuk tujuan ini.
| Terus-menerus | Definisi |
|---|---|
| CMSG_OID_CNG_IMPORT_KEY_AGREE_FUNC | "CryptMsgDllCNGImportKeyAgree" |
Contoh
Untuk contoh yang menyebarkan fungsi panggilan balik yang dapat diinstal OID, lihat Memperluas Fungsionalitas CryptoAPI.
Persyaratan
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | wincrypt.h |