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

Функция обратного вызова 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

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

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 [только классические приложения]
Целевая платформа	Windows
Header	wincrypt.h