Метод ICPSignedData2::EnhanceCades

Синтаксис

C++

Visual Basic 6

 HRESULT EnhanceCades (
   CADESCOM_CADES_TYPE CadesType,
   BSTR TSAAddress,
   CAPICOM_ENCODING_TYPE EncodingType,
   BSTR *pVal
 );

 Function EnhanceCades ( _
   [CadesType As CADESCOM_CADES_TYPE], _
   [TSAAddress As String], _
   [EncodingType As CAPICOM_ENCODING_TYPE] _
 ) As String

Параметры

CadesType: [in, optional] Тип усовершенствованной подписи (см. CADESCOM_CADES_TYPE). По умолчанию CAdES-X Long Type 1.

TSAAddress: [in, optional] Адрес службы штампов времени.

EncodingType: [in, optional] Кодировка возвращаемой подписи (см. CAPICOM.CAPICOM_ENCODING_TYPE ). По умолчанию CAPICOM_ENCODE_BASE64. В КриптоПро ЭЦП Browser plug-in кодировка DER (параметр CAPICOM_ENCODE_BINARY) не поддерживается. См. замечание.

pVal: [out, retval] Возвращаемое значение подписи.

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

Возвращаемое значение имеет тип HRESULT. Значение S_OK означает успешное выполнение.

Параметры

CadesType: Тип усовершенствованной подписи (см. CADESCOM_CADES_TYPE). По умолчанию CAdES-X Long Type 1.

TSAAddress: Адрес службы штампов времени.

EncodingType: Кодировка возвращаемой подписи (см. CAPICOM.CAPICOM_ENCODING_TYPE ). По умолчанию CAPICOM_ENCODE_BASE64. В КриптоПро ЭЦП Browser plug-in кодировка DER (параметр CAPICOM_ENCODE_BINARY) не поддерживается. См. замечание.

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

Возвращаемое значение подписи.

Примечания

С помощью данного метода подпись, созданная в формате CAdES BES, может быть дополнена до усовершенствованной подписи CADES-X Long Type 1. Если исходная подпись не соответствует формату CAdES BES, то она не может быть дополнена ни до CAdES BES, ни до CADES-X Long Type 1.

Если параметр CadesType имеет значение CADES_X_LONG_TYPE_1, то метод EnhanceCades добавляет к уже готовой подписи неподписанные атрибуты, необходимые для соответствия CADES-X Long Type 1 (штампы времени на подпись и на доказательства подлинности, ссылки на сертификаты и информацию об отзыве, значения сертификатов, CRL и OCSP ответов, использовавшихся при проверке цепочки). Если параметр CadesType имеет значение CADES_BES, то метод EnhanceCades проверяет подпись на соответствие формату CAdES BES, без добавления дополнительных атрибутов. Точно так же, если параметр CadesType имеет значение CADES_X_LONG_TYPE_1 то сначала проверяется, не соответствует ли уже подпись формату CADES_X_LONG_TYPE_1 (cоответствие определяется по наличию нужных атрибутов), и если соответствует, то метод EnhanceCades успешно завершает свою работу, не внося никаких изменений.

Замечание
В КриптоПро ЭЦП Browser plug-in кодировка DER (параметр CAPICOM_ENCODE_BINARY) не поддерживается. См. Особенности работы с бинарными данными.

Замечание

В КриптоПро ЭЦП Browser plug-in кодировка DER (параметр CAPICOM_ENCODE_BINARY) не поддерживается. См. Особенности работы с бинарными данными.

Требования

Заголовочный файл	cadescom.h
Библиотека DLL	cadescom.dll
Идентификаторы GUID	cadescom_i.c
Минимальная версия продукта	1.0

См. также

CADESCOM_CADES_TYPE, CAPICOM.CAPICOM_ENCODING_TYPE