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

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

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

Назначение Имя файла
Заголовочный файл cadescom.h
Идентификаторы GUID cadescom_i.c
Библиотека DLL cadescom.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 Pro\SDK\include\.

Использование

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

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

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

    C/C++
    #include <cadescom.h>
    
    Для получения идентификаторов GUID интерфейса или класса, можно воспользоваться оператором __uuidof(). Например:
    C++
    CoCreateInstance(&__uuidof(CadesSignedData), ...);
    
    Если Вы используете язык программирования С, следует включить в код приложения файл идентификаторов GUID cadescom_i.c, входящий в состав SDK. При этом файл cadescom_i.c необходимо включить в код приложения только однажды, повторное включение приведет к ошибке компоновщика (линкера). Альтернативно можно подключить в проект этот файл как отдельную единицу компиляции.
    C
    #include <cadescom_i.c>
    
    В этом случае создать объект можно, например, так:
    C
    CoCreateInstance(&CLSID_CadesSignedData, ...);
    

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

    C/C++
    #import "cadescom.dll"
    

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

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

Установка библиотеки cadescom.dll на компьютере пользователя

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

Библиотека cadescom.dll устанавливается в папку %CommonProgramFiles%\Crypto Pro\Shared\ и регистрируется в реестре с указанием полного пути к ней.