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

Функция CadesMsgIsType

Проверяет соответствие заданному типу усовершенствованной подписи.

Синтаксис

C/C++
 BOOL CadesMsgIsType (
   __in HCRYPTMSG hCryptMsg,
   __in DWORD dwSignatureIndex,
   __in DWORD dwCadesType,
   __out BOOL *pbResult
 );

Параметры

hCryptMsg

[in] Дескриптор подписанного сообщения, должен быть открыт с помощью CryptMsgOpenToDecode .

dwSignatureIndex

[in] Номер обрабатываемой подписи.

dwCadesType

[in] Необходимый тип усовершенствованной подписи (см. примечания).

pbResult

[out] Результат проверки. Заполняется при успешном завершении функции. TRUE означает, что подпись соответствует заданному типу.

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

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

Примечания

Функция проверяет соответствие подписи заданному типу лишь по признакам наличия тех или иных атрибутов. Она предназначена для предварительного анализа полученного подписанного сообщения с целью дальнейшего формирования необходимых параметров проверки с учётом типа усовершенствованной подписи. Для криптографической проверки подписи и сертификата ключа подписи необходимо использовать функции CadesMsgVerifySignature, CadesMsgVerifyCountersignatureEncoded, CadesMsgVerifyCountersignatureEncodedEx, CadesVerifyMessage или CadesVerifyDetachedMessage.

В случае отделённой подписи для работы функции CadesMsgIsType нет необходимости подавать в CryptMsgUpdate подписанные данные, достаточно подать только отделённую подпись.

Замечание

Типы усовершенствованной подписи могут вкладываться друг в друга. Например, подпись CAdES-X Long Type 1 является частным случаем подписи CAdES BES, поэтому проверка такой подписи на соответствие типу CAdES BES вернёт положительный результат.

Параметр dwCadesType может принимать следующие значения:
Имя Описание
CADES_X_LONG_TYPE_1

Тип сообщения CAdES-X Long Type 1.

CADES_BES

Тип сообщения CAdES BES.

CADES_T

Тип сообщения CAdES-T.

CADES_DEFAULT

Эквивалентен CADES_X_LONG_TYPE_1.

Требования

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