структура CMSG_MAIL_LIST_ENCRYPT_INFO (wincrypt.h)

Статья
07/16/2024

Структура CMSG_MAIL_LIST_ENCRYPT_INFO содержит сведения о шифровании для получателя списка рассылки конвертированных данных. Функция PFN_CMSG_EXPORT_MAIL_LIST обновляет эту структуру.

Синтаксис

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;

Члены

cbSize

Размер этой структуры в байтах.

dwRecipientIndex

Значение, указывающее порядковый номер получателя в списке получателей, указанный параметром pContentEncryptInfo функции PFN_CMSG_EXPORT_MAIL_LIST.

KeyEncryptionAlgorithm

Структура CRYPT_ALGORITHM_IDENTIFIER, указывающая алгоритм, используемый для шифрования ключа шифрования содержимого. Функция CryptMsgOpenToEncode использует элемент pszObjIdCRYPT_ALGORITHM_IDENTIFIER для получения адреса функции, используемой для экспорта ключа. Функцию можно установить с помощью API шифрования: идентификатор объекта следующего поколения (CNG) (OID).

EncryptedKey

Структура CRYPT_DATA_BLOB, содержащая зашифрованный ключ сеанса.

dwFlags

Значение, указывающее, какие элементы были обновлены, и выделение памяти которого должно быть освобождено с помощью функции CryptMsgOpenToEncode.

Ценность	Значение
CMSG_MAIL_LIST_ENCRYPT_FREE_OBJID_FLAG 0x00000002	Был обновлен элемент pszObjId структуры CRYPT_ALGORITHM_IDENTIFIER, на которую ссылается элемент KeyEncryptionAlgorith m.
CMSG_MAIL_LIST_ENCRYPT_FREE_PARA_FLAG 0x00000001	Элемент ParameterspbData структуры CRYPT_ALGORITHM_IDENTIFIER, на которую ссылается элемент KeyEncryptionAlgorithm.

Замечания

При вызове с параметром dwMsgType задано значение CMSG_ENVELOPED, функция CryptMsgOpenToEncode инициализирует структуру CMSG_MAIL_LIST_ENCRYPT_INFO из структуры CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO. Функция CryptMsgOpenToEncode вызывает функцию PFN_CMSG_EXPORT_MAIL_LIST для обновления структуры CMSG_MAIL_LIST_ENCRYPT_INFO. Если не удается найти функцию обратного вызова, функция CryptMsgOpenToEn code заполняет эту структуру сведениями ключа по умолчанию из структуры CMSG_CONTENT_ENCRYPT_INFO.

Следующие элементы структуры CMSG_MAIL_LIST_ENCRYPT_INFO можно обновить функцией обратного вызова:

EncryptedKey

KeyEncryptionAlgorithm.pszObjId

KeyEncryptionAlgorithm.Parameters

dwFlags

Другие члены доступны только для чтения.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
заголовка	wincrypt.h

См. также

кодирование конвертированных данных

Поделиться через