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

Метод ICPSignedData4::SignHash

Создает усовершенствованную подпись.

Синтаксис

C++
Visual Basic 6
 HRESULT SignHash (
   IHashedData *Hash,
   VARIANT Signer,
   CADESCOM_CADES_TYPE CadesType,
   CAPICOM_ENCODING_TYPE EncodingType,
   BSTR *pVal
 );
 Function SignHash ( _
   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) не поддерживается. См. замечание.

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

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

Примечания

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

Замечание

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

Требования

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