struktur CMSG_MAIL_LIST_ENCRYPT_INFO (wincrypt.h)

Artikel
07/16/2024

Struktur CMSG_MAIL_LIST_ENCRYPT_INFO berisi informasi enkripsi untuk penerima milis data yang diselimuti. Fungsi PFN_CMSG_EXPORT_MAIL_LIST memperbarui struktur ini.

Sintaksis

typedef struct _CMSG_MAIL_LIST_ENCRYPT_INFO {
  DWORD                      cbSize;
  DWORD                      dwRecipientIndex;
  CRYPT_ALGORITHM_IDENTIFIER KeyEncryptionAlgorithm;
  CRYPT_DATA_BLOB            EncryptedKey;
  DWORD                      dwFlags;
} CMSG_MAIL_LIST_ENCRYPT_INFO, *PCMSG_MAIL_LIST_ENCRYPT_INFO;

Anggota

cbSize

Ukuran, dalam byte, dari struktur ini.

dwRecipientIndex

Nilai yang menentukan nomor ordinal penerima dalam daftar penerima yang ditentukan oleh parameter pContentEncryptInfo ke fungsi PFN_CMSG_EXPORT_MAIL_LIST.

KeyEncryptionAlgorithm

Struktur CRYPT_ALGORITHM_IDENTIFIER yang menentukan algoritma yang digunakan untuk mengenkripsi kunci enkripsi konten. Fungsi CryptMsgOpenToEncode menggunakan pszObjId anggota struktur CRYPT_ALGORITHM_IDENTIFIER untuk mendapatkan alamat fungsi yang digunakan untuk mengekspor kunci. Fungsi ini dapat diinstal dengan menggunakan Cryptography API: Next Generation (CNG) pengidentifikasi objek (OID).

EncryptedKey

Struktur CRYPT_DATA_BLOB yang berisi kunci sesi terenkripsi.

dwFlags

Nilai yang menentukan anggota apa yang telah diperbarui, dan yang alokasi memorinya harus dibebaskan dengan menggunakan fungsi CryptMsgOpenToEncode.

Nilai	Arti
CMSG_MAIL_LIST_ENCRYPT_FREE_OBJID_FLAG 0x00000002	Anggota pszObjId dari struktur CRYPT_ALGORITHM_IDENTIFIER yang dimaksud oleh anggota KeyEncryptionAlgorithm diperbarui.
CMSG_MAIL_LIST_ENCRYPT_FREE_PARA_FLAG 0x00000001	Parameter pbData anggota struktur CRYPT_ALGORITHM_IDENTIFIER yang dimaksud oleh anggota KeyEncryptionAlgorithm diperbarui.

Komentar

Ketika dipanggil dengan parameter dwMsgType diatur ke CMSG_ENVELOPED, fungsi CryptMsgOpenToEncode menginisialisasi struktur CMSG_MAIL_LIST_ENCRYPT_INFO dari struktur CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO. Fungsi CryptMsgOpenToEncode memanggil fungsi PFN_CMSG_EXPORT_MAIL_LIST untuk memperbarui struktur CMSG_MAIL_LIST_ENCRYPT_INFO. Jika fungsi panggilan balik tidak dapat ditemukan, fungsi CryptMsgOpenToEncode mengisi struktur ini dengan informasi kunci default dari struktur CMSG_CONTENT_ENCRYPT_INFO.

Anggota struktur CMSG_MAIL_LIST_ENCRYPT_INFO berikut dapat diperbarui oleh fungsi panggilan balik:

EncryptedKey

KeyEncryptionAlgorithm.pszObjId

KeyEncryptionAlgorithm.Parameters

dwFlags

Anggota lain bersifat baca-saja.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	wincrypt.h

Lihat juga

Encoding Enveloped Data

Bagikan melalui