Создает усовершенствованную подпись.
Синтаксис
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 |