Использование интерфейса COM (только для Windows)

На чтение 4 мин. Просмотров 42 Опубликовано

Cadescom: объекты

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

ИмяОписание
class memberAboutВерсия библиотеки.
class memberAlgorithmОписывает алгоритм шифрования. Реализует интерфейс, аналогичный интерфейсу объекта CAPICOM.AlgorithmИспользование интерфейса COM (только для Windows).
class memberBasicConstraintsОписывает основные ограничения на использование сертификата. Реализует интерфейс, аналогичный интерфейсу объекта CAPICOM.BasicConstraintsИспользование интерфейса COM (только для Windows).
class memberCadesSignedDataПодписанные данные.
class memberCertificatesОписывает коллекцию сертификатов. Реализует интерфейс, аналогичный интерфейсу объекта CAPICOM.CertificatesИспользование интерфейса COM (только для Windows).
class memberCertificateStatusОписывает статус сертификата открытого ключа. Реализует интерфейс, аналогичный интерфейсу объекта CAPICOM.CertificateStatusИспользование интерфейса COM (только для Windows).
class memberCPAttributeАтрибут усовершенствованной подписи (подписанный или неподписанный).
class memberCPAttributesКоллекция объектов CPAttribute.
class memberCPBlobsКоллекция бинарных объектов.
class memberCPCertificateОписывает сертификат открытого ключа. Реализует интерфейс, аналогичный интерфейсу объекта CAPICOM.CertificateИспользование интерфейса COM (только для Windows), а также интерфейс IAdditionalStore.
class memberCPCRLОбъект для работы со списком отозванных сертификатов.
class memberCPEnvelopedDataЗашифрованное сообщение.
class memberCPHashedDataХэш-значение данных.
class memberCPLicenseОбъект для работы с лицензиями на продукты КриптоПро.
class memberCPReadersОбъект для работы с коллекцией доступных считывателей.
class memberCPSignerОбъект, задающий параметры создания и содержащий информацию об усовершенствованной подписи.
class memberCPSignersКоллекция объектов CPSigner.
class memberEKUОписывает расширение EKU сертификата. Реализует интерфейс, аналогичный интерфейсу объекта CAPICOM.EKUИспользование интерфейса COM (только для Windows).
class memberEKUsОписывает коллекцию расширений EKU сертификата. Реализует интерфейс, аналогичный интерфейсу объекта CAPICOM.EKUsИспользование интерфейса COM (только для Windows).
class memberEncodedDataОписывает закодированный блок данных. Реализует интерфейс, аналогичный интерфейсу объекта CAPICOM.EncodedDataИспользование интерфейса COM (только для Windows).
class memberEnrollReaderModeРежим работы доступного считывателя.
class memberEnrollReaderModesКоллекция режимов работы доступных считывателей.
class memberEnrollX509ExtensionIdentificationKindОбъект для добавления способа идентификации заявителя при выдаче сертификата ключа проверки ЭП.
class memberEnrollX509ExtensionSubjectSignToolОбъект для добавления информации об СКЗИ в запрос на сертификат.
class memberEnrollX509NameValuePairОбъект для добавления атрибута типа имя-значение в запрос на сертификат.
class memberEnrollX509NameValuePairsКоллекция объектов EnrollX509NameValuePair.
class memberExtendedKeyUsageОписывает расширенное использование ключа. Реализует интерфейс, аналогичный интерфейсу объекта CAPICOM.ExtendedKeyUsageИспользование интерфейса COM (только для Windows).
class memberKeyUsageОписывает расширение KeyUsage сертификата. Реализует интерфейс, аналогичный интерфейсу объекта CAPICOM.KeyUsageИспользование интерфейса COM (только для Windows).
class memberOIDОписывает объектный идентификатор. Реализует интерфейс, аналогичный интерфейсу объекта CAPICOM.OIDИспользование интерфейса COM (только для Windows).
class memberPrivateKeyОписывает закрытый ключ сертификата. Обьект предоставляет интерфейс CAdESCOM.ICPPrivateKey и интерфейс аналогичный интерфейсу объекта CAPICOM.PrivateKeyИспользование интерфейса COM (только для Windows).
class memberPrivateKeyUsageValidatorОбъект описан в составе документации библиотеки PKIValidatorИспользование интерфейса COM (только для Windows).
class memberPublicKeyОписывает открытый ключ сертификата. Реализует интерфейс, аналогичный интерфейсу объекта CAPICOM.PublicKeyИспользование интерфейса COM (только для Windows).
class memberRawSignatureЗначение электронной подписи.
class memberRecipientsОписывает коллекцию сертификатов для шифрования. Реализует интерфейс, аналогичный интерфейсу объекта CAPICOM.RecipientsИспользование интерфейса COM (только для Windows).
class memberSignatureStatusСтатус электронной подписи.
class memberSignedXMLПодписанный документ XML.
class memberStoreОписывает хранилище сертификатов. Реализует интерфейс, аналогичный интерфейсу объекта CAPICOM.StoreИспользование интерфейса COM (только для Windows), а также интерфейс IEventSource.
class memberSymmetricAlgorithmОбъект SymmetricAlgorithm предоставляет свойства и методы для работы с симметричными ключами и шифрования / расшифрования данных на симметричных ключах.
class memberVersionОписывает версию.
ЭЦП:  КРИПТОПРОВАЙДЕР ТИП 424

Использование интерфейса com (только для windows)

Интерфейс COM описан в настоящем руководстве. Для его использования в инструментарий разработчика включены следующие файлы:

НазначениеИмя файла
Заголовочный файлcadescom.h
Идентификаторы GUIDcadescom_i.c
Библиотека DLLcadescom.dll — для платформ Win32 и x64
Модуль слиянияcadescom_win32.msm, cadescom_x64.msm
Пакет для установкиcadescom-win32.msi, cadescom-x64.msi

  1. Установите на Ваш компьютер КриптоПро ЭЦП SDK

  2. Убедитесь, что переменная окружения INCLUDE (путь к заголовочным файлам) содержит путь к заголовочным файлам КриптоПро ЭЦП SDK.
    В Microsoft Visual Studio это можно настроить следующим образом: в окне настроек Tools->Options в левом столбце выберите пункт Projects and Solutions->VC Directories. Справа из ниспадающего меню выбора типа файлов Show directories for выберите пункт Include files.
    Заголовочный файл cadescom.h устанавливается в каталог %ProgramFiles%Crypto ProSDKinclude.

Язык программирования С/С

Для использования интерфейса COM существуют следующие возможности:

  • Включить в код приложения заголовочный файл cadescom.h, входящий в состав SDK:

    Для получения идентификаторов GUID интерфейса или класса, можно воспользоваться оператором __uuidof(). Например: Если вы используете язык программирования С, следует включить в код приложения файл идентификаторов GUID cadescom_i.c, входящий в состав SDK. При этом файл cadescom_i.c необходимо включить в код приложения только однажды, повторное включение приведет к ошибке компоновщика (линкера). Альтернативно можно подключить в проект этот файл как отдельную единицу компиляции. В этом случае создать объект можно, например, так:

  • Импортировать библиотеку cadescom.dll. При этом библиотека cadescom.dll должна находиться в каталоге, указанном в пути INCLUDE либо в одном каталоге с исходными файлами Вашего приложения.

Другие языки программирования

Если используемый Вами язык программирования и среда разработки поддерживают COM, следуйте инструкциям, изложенным в руководстве по используемой Вами среде разработки.

Для установки библиотеки cadescom.dll на компьютере пользователя рекомендуется воспользоваться модулем слиянияcadescom_win32.msm или cadescom_x64.msm в зависимости от требуемой платформы. Если Ваше приложение не имеет собственного установочного пакета, то можно воспользоваться пакетами Windows Installer cades-win32.msi или cades-x64.msi. Данные пакеты находятся в папке %ProgramFiles%Crypto ProSDKbin.

Библиотека cadescom.dll устанавливается в папку

%CommonProgramFiles%Crypto ProShared

и регистрируется в реестре с указанием полного пути к ней.

Оцените статью
ЭЦП64
© 2025 ЭЦП64