Использование интерфейса 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

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

Установка

Установите на Ваш компьютер КриптоПро ЭЦП SDK
Убедитесь, что переменная окружения 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\ и регистрируется в реестре с указанием полного пути к ней.