функция обратного вызова PFN_CMSG_EXPORT_MAIL_LIST (wincrypt.h)

Статья
07/16/2024

Функция обратного вызова PFN_CMSG_EXPORT_MAIL_LIST шифрует и экспортирует ключ шифрования содержимого для получателя списка рассылки конвертированного сообщения. PFN_CMSG_EXPORT_MAIL_LIST можно установить с помощью идентификатора объекта cryptoAPI (OID). Эта функция вызывается функцией CryptMsgOpenToEncode, если для параметра dwMsgType задано значение CMSG_ENVELOPED.

Синтаксис

PFN_CMSG_EXPORT_MAIL_LIST PfnCmsgExportMailList;

BOOL PfnCmsgExportMailList(
  [in]      PCMSG_CONTENT_ENCRYPT_INFO pContentEncryptInfo,
  [in]      PCMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO pMailListEncodeInfo,
  [in, out] PCMSG_MAIL_LIST_ENCRYPT_INFO pMailListEncryptInfo,
  [in]      DWORD dwFlags,
            void *pvReserved
)
{...}

Параметры

[in] pContentEncryptInfo

Указатель на CMSG_CONTENT_ENCRYPT_INFO структуру, содержащую ключ шифрования содержимого.

[in] pMailListEncodeInfo

Указатель на структуру CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO, указывающую ключ, используемый для шифрования ключа шифрования содержимого.

[in, out] pMailListEncryptInfo

Указатель на структуру CMSG_MAIL_LIST_ENCRYPT_INFO, содержащую зашифрованный ключ шифрования содержимого.

[in] dwFlags

Это значение не используется. Присвойте ему значение нулю.

pvReserved

Этот параметр зарезервирован и должен быть null.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение ненулевое (TRUE).

Если функция завершается ошибкой, возвращаемое значение равно нулю (FALSE). Для получения расширенных сведений об ошибке вызовите GetLastError.

Замечания

Функция PFN_CMSG_EXPORT_MAIL_LIST должна обновить элемент EncryptedKey структуры CMSG_MAIL_LIST_ENCRYPT_INFO, на которую указывает параметр pMailListEncryptInfo. Эта функция должна использовать pfnAlloc и pfnFree членов структуры CMSG_CONTENT_ENCRYPT_INFO, на которую указывает параметр pContentEncryptInfo для управления памятью для всех значений, которые он обновляет.

Функции поддержки OID можно использовать для развертывания этой функции обратного вызова. Wincrypt.h определяет следующие константы для этой цели.

Постоянный	Определение
CMSG_OID_EXPORT_MAIL_LIST_FUNC или CMSG_OID_CAPI1_EXPORT_MAIL_LIST_FUNC	"CryptMsgDllExportMailList"

Требования

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

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