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

Метод ICPSignedData4::CoSignHash

Добавляет к сообщению усовершенствованную подпись.

Синтаксис

C++
Visual Basic 6
 HRESULT CoSignHash (
   IHashedData *Hash,
   VARIANT Signer,
   CADESCOM_CADES_TYPE CadesType,
   CAPICOM_ENCODING_TYPE EncodingType,
   BSTR *pVal
 );
 Function CoSignHash ( _
   Hash As IHashedData, _
   [Signer As Variant], _
   [CadesType As CADESCOM_CADES_TYPE], _
   [EncodingType As CAPICOM_ENCODING_TYPE] _
 ) As String

Параметры

Hash

[in] Объект CAdESCOM.HashedData, соответствующий хэш-значению, для которого следует добавить электронную подпись в CMS-сообщение.

Signer

[in, optional] Объект CPSigner или CAPICOM.Signer , который будет использован для создания подписи. По умолчанию не задан, при этом выбор сертификата для подписи производится аналогично методу Sign объекта CAPICOM.SignedData при отсутствии первого параметра. Таким же образом выбор сертификата для подписи производится в случае, если параметр pSigner задан, но не содержит сертификата для подписи.

CadesType

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

EncodingType

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

pVal

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

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

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

Параметры

Hash

Объект CAdESCOM.HashedData, соответствующий хэш-значению, для которого следует добавить электронную подпись в CMS-сообщение.

Signer

Объект CPSigner или CAPICOM.Signer , который будет использован для создания подписи. По умолчанию не задан, при этом выбор сертификата для подписи производится аналогично методу Sign объекта CAPICOM.SignedData при отсутствии первого параметра. Таким же образом выбор сертификата для подписи производится в случае, если параметр pSigner задан, но не содержит сертификата для подписи.

CadesType

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

EncodingType

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

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

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

Примечания

Метод CoSignHash позволяет добавить в сообщение усовершенствованную подпись на основе переданного хэш-значения.

Замечание

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

Требования

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