Развернуть все
Свернуть все

Функция CadesVerifyMessage

Аналог функции CryptVerifyMessageSignature для работы с усовершенствованной подписью.

Синтаксис

C/C++
 BOOL CadesVerifyMessage (
   __in PCADES_VERIFY_MESSAGE_PARA pVerifyPara,
   __in DWORD dwSignerIndex,
   __in const BYTE *pbSignedBlob,
   __in DWORD cbSignedBlob,
   __out_opt PCRYPT_DATA_BLOB *ppDecodedBlob,
   __out_opt PCADES_VERIFICATION_INFO *ppVerificationInfo
 );

Параметры

pVerifyPara

[in] Указатель на структуру CADES_VERIFY_MESSAGE_PARA. В этой структуре может быть указан тип подписи, соответствие которому следует проверить.

dwSignerIndex

[in] Аналогичен параметру функции CryptVerifyMessageSignature .

pbSignedBlob

[in] Аналогичен параметру функции CryptVerifyMessageSignature .

cbSignedBlob

[in] Аналогичен параметру функции CryptVerifyMessageSignature .

ppDecodedBlob

[out, optional] Указатель на указатель на структуру CRYPT_DATA_BLOB . В этой структуре возвращается подписанное содержимое сообщения. Структура должна быть освобождена после использования с помощью CadesFreeBlob.

ppVerificationInfo

[out, optional] Указатель на указатель на структуру CADES_VERIFICATION_INFO, в которой возвращается дополнительная информация о подписи после проверки. Структура должна быть освобождена после использования с помощью функции CadesFreeVerificationInfo (даже в случае неуспешного завершения работы функции).

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

TRUE в случае успеха, FALSE в случае неудачи, дополнительную информацию об ошибке можно получить через GetLastError или в структуре CADES_VERIFICATION_INFO.

Примечания

Эту функцию нужно вызывать только один раз (в отличие от функции CryptVerifyMessageSignature , которая вызывается дважды: для получения длины и для получения самого сообщения). Подписанное содержимое сообщения возвращается в ppDecodedBlob, после использования его нужно освободить с помощью функции CadesFreeBlob. Кроме того, возвращается указатель на структуру CADES_VERIFICATION_INFO, в которой содержится дополнительная информация о подписи после проверки. Структура должна быть освобождена после использования с помощью функции CadesFreeVerificationInfo.

Требования

Заголовочный файл cades.h
Библиотека cades.dll (Windows), cades.so (Unix)
Библиотека импорта cades.lib (Windows)
Минимальная версия продукта 1.0