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

Статья
07/16/2024

Функция обратного вызова PFN_CMSG_IMPORT_MAIL_LIST импортирует ключ шифрования содержимого для получателя транспорта ключа конвертированного сообщения. PFN_CMSG_IMPORT_MAIL_LIST можно установить с помощью идентификатора объекта CryptoAPI. Эта функция вызывается функцией CryptMsgControl, если для параметра dwCtrlType задано значение CMSG_CTRL_DECRYPT.

Синтаксис

PFN_CMSG_IMPORT_MAIL_LIST PfnCmsgImportMailList;

BOOL PfnCmsgImportMailList(
  [in]  PCRYPT_ALGORITHM_IDENTIFIER pContentEncryptionAlgorithm,
  [in]  PCMSG_CTRL_MAIL_LIST_DECRYPT_PARA pMailListDecryptPara,
  [in]  DWORD dwFlags,
        void *pvReserved,
  [out] HCRYPTKEY *phContentEncryptKey
)
{...}

Параметры

[in] pContentEncryptionAlgorithm

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

[in] pMailListDecryptPara

Указатель на структуру CMSG_CTRL_MAIL_LIST_DECRYPT_PARA, содержащую сведения о получателе списка рассылки.

[in] dwFlags

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

pvReserved

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

[out] phContentEncryptKey

Адрес дескриптора ключа шифрования содержимого, возвращаемого этой функцией.

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

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

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

Если эта функция обратного вызова не поддерживает алгоритм шифрования ключей, он должен возвращать FALSE и вызывать SetLastError с E_NOTIMPL.

Замечания

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

Постоянный	Определение
CMSG_OID_IMPORT_MAIL_LIST_FUNC или CMSG_OID_CAPI1_IMPORT_MAIL_LIST_FUNC	"CryptMsgDllImportMailList"

Требования

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

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