PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY fungsi panggilan balik (wincrypt.h)

  • Artikel

Fungsi panggilan balik PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY mengimpor kunci enkripsi konten (CEK) yang sudah didekripsi. Fungsi PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY dapat diinstal dengan menggunakan API Kriptografi: Pengidentifikasi objek (OID) Generasi Berikutnya (CNG).

Sintaks

PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY PfnCmsgCngImportContentEncryptKey;

BOOL PfnCmsgCngImportContentEncryptKey(
  [in, out] PCMSG_CNG_CONTENT_DECRYPT_INFO pCNGContentDecryptInfo,
  [in]      DWORD dwFlags,
            void *pvReserved
)
{...}

Parameter

[in, out] pCNGContentDecryptInfo

Penunjuk ke struktur CMSG_CNG_CONTENT_DECRYPT_INFO yang akan diperbarui dengan CEK yang diimpor. Struktur ini berisi semua informasi relevan yang diteruskan ke fungsi CryptMsgControl .

[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-nya :

CMSG_CTRL_DECRYPT
CMSG_CTRL_KEY_TRANS_DECRYPT
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_CONTENT_ENCRYPT_KEY_FUNC "CryptMsgDllCNGImportContentEncryptKey"
 

Contoh

Untuk contoh yang menyebarkan fungsi panggilan balik yang dapat diinstal OID, lihat Memperluas Fungsionalitas CryptoAPI.

Persyaratan

Persyaratan Nilai
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

Lihat juga

Pendekodean Data Yang Diselubungi