Функция CryptMsgControl выполняет контрольное действие после того, как сообщение было раскодировано последним вызовом функции CryptMsgUpdate. Контрольные операции, обеспеченные этой функцией, используются при расшифровании, проверке электронной подписи и хэша, а также при добавлении и удалении сертификатов, СОС, подписей и недостоверных атрибутов.
WINCRYPT32API BOOL WINAPI CryptMsgControl( IN HCRYPTMSG hCryptMsg, IN DWORD dwFlags, IN DWORD dwCtrlType, IN void const * pvCtrlPara );
При добавлении подписи при помощи функции CryptMsgControl в создаваемую подпись будут добавлены дополнительные подписанные атрибуты (см. Особенности создания подписанных CMS сообщений в КриптоПро CSP 3.6 и выше ). На добавление атрибутов влияет параметр dwFlags. Параметр dwFlags может содержать дополнительные флаги, определённые в файле WinCryptEx.h:
Флаг | Описание |
---|---|
CPCMSG_CADES_DISABLE | Отключает добавление атрибутов. Данный флаг не может быть указан одновременно с CPCMSG_CADES_STRICT. |
CPCMSG_CADES_STRICT | Если не удалось добавить атрибуты, функция вернёт ошибку. Данный флаг не может быть указан одновременно с CPCMSG_CADES_DISABLE. |
CPCMSG_CADES_DISABLE_CERT_SEARCH | Отключает поиск сертификата подписывающего в хранилищах "Личные" ("My") текущего пользователя и локального компьютера. |
AIX: 5/6/7 или выше.
FreeBSD: 7/8/9 или выше.
Linux: LSB 3.1 (RHEL 4, SuSE 10) или выше.
Solaris: 10/11 или выше.
Mac OSX: 10.7/8 или выше.
iOS: 6/7 или выше.
Файл описания: Прототип описан в файлах CSP_WinCrypt.h и WinCryptEx.h.
Низкоуровневые функции обработки криптографических сообщений , Высокоуровневые функции обработки криптографических сообщений , CryptMsgGetAndVerifySigner, CryptMsgControl в MS CryptoAPI 2.0