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

  • Статья

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

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

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