PFN_CMSG_IMPORT_KEY_AGREE fungsi panggilan balik (wincrypt.h)

  • Artikel

Fungsi panggilan balik PFN_CMSG_IMPORT_KEY_AGREE mengimpor kunci enkripsi konten untuk penerima transportasi utama pesan yang diselimuti. PFN_CMSG_IMPORT_KEY_AGREE dapat diinstal dengan menggunakan pengidentifikasi objekCryptoAPI (OID). Fungsi ini dipanggil oleh fungsi CryptMsgControl ketika parameter dwCtrlType diatur ke CMSG_CTRL_DECRYPT.

Sintaks

PFN_CMSG_IMPORT_KEY_AGREE PfnCmsgImportKeyAgree;

BOOL PfnCmsgImportKeyAgree(
  [in]  PCRYPT_ALGORITHM_IDENTIFIER pContentEncryptionAlgorithm,
  [in]  PCMSG_CTRL_KEY_AGREE_DECRYPT_PARA pKeyAgreeDecryptPara,
  [in]  DWORD dwFlags,
        void *pvReserved,
  [out] HCRYPTKEY *phContentEncryptKey
)
{...}

Parameter

[in] pContentEncryptionAlgorithm

Penunjuk ke struktur CRYPT_ALGORITHM_IDENTIFIER yang menentukan algoritma yang digunakan untuk mengenkripsi konten pesan dan parameter terkait.

[in] pKeyAgreeDecryptPara

Penunjuk ke struktur CMSG_CTRL_KEY_AGREE_DECRYPT_PARA yang berisi informasi tentang penerima perjanjian kunci.

[in] dwFlags

Nilai ini tidak digunakan. Atur ke nol.

pvReserved

Parameter ini dicadangkan dan harus NULL.

[out] phContentEncryptKey

Alamat handel ke kunci enkripsi konten yang dikembalikan oleh fungsi ini.

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 E_NOTIMPL.

Keterangan

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_IMPORT_KEY_AGREE_FUNC atau CMSG_OID_CAPI1_IMPORT_KEY_AGREE_FUNC "CryptMsgDllImportKeyAgree"

Persyaratan

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