Использование интерфейса языка С

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

Назначение Имя файла

Заголовочный файл ades-core.h

Заголовочный файл cades.h

Заголовочный файл xades.h

Библиотека импорта cades.lib - для платформ Win32 и x64 (только для Windows)

Библиотека импорта xades.lib - для платформ Win32 и x64 (только для Windows)

Динамическая библиотека
cades.dll - для платформ Win32 и x64 (Windows)

libxades.so - для платформ ia32 и x64 (Unix)

Динамическая библиотека
xades.dll - для платформ Win32 и x64 (Windows)

libxades.so - для платформ ia32 и x64 (Unix)

Модуль слияния cades_win32.msm, cades_x64.msm (только для Windows)

Пакет для установки
cades-win32.msi, cades-x64.msi (Windows)

*cades*.rpm (Unix)

Назначение	Имя файла
Заголовочный файл	ades-core.h
Заголовочный файл	cades.h
Заголовочный файл	xades.h
Библиотека импорта	cades.lib - для платформ Win32 и x64 (только для Windows)
Библиотека импорта	xades.lib - для платформ Win32 и x64 (только для Windows)
Динамическая библиотека	cades.dll - для платформ Win32 и x64 (Windows) libxades.so - для платформ ia32 и x64 (Unix)
Динамическая библиотека	xades.dll - для платформ Win32 и x64 (Windows) libxades.so - для платформ ia32 и x64 (Unix)
Модуль слияния	cades_win32.msm, cades_x64.msm (только для Windows)
Пакет для установки	cades-win32.msi, cades-x64.msi (Windows) cades.rpm (Unix)

Установка (Windows)

Установите на ваш компьютер КриптоПро ЭЦП SDK (cadessdk.msi).
Если вы планируете запускать 64-разрядное приложение, то установите на ваш компьютер 64-разрядный КриптоПро ЭЦП Runtime (cades-x64.msi).
Убедитесь, что переменная окружения INCLUDE (путь к заголовочным файлам) содержит путь к заголовочным файлам КриптоПро ЭЦП SDK.
В Microsoft Visual Studio это можно настроить следующим образом: в окне настроек Tools->Options в левом столбце выберите пункт Projects and Solutions->VC++ Directories. Справа из ниспадающего меню выбора типа файлов Show directories for выберите пункт Include files.
Заголовочный файл cades.h устанавливается в каталог %ProgramFiles%\Crypto Pro\SDK\include\.
Убедитесь, что переменная окружения LIB (путь к файлам библиотек) содержит путь к файлам библиотек КриптоПро ЭЦП SDK.
В Microsoft Visual Studio это можно настроить следующим образом: в окне настроек Tools->Options в левом столбце выберите пункт Projects and Solutions->VC++ Directories. Справа из ниспадающего меню выбора типа файлов Show directories for выберите пункт Library files.
Для платформы Win32 cades.lib устанавливается в каталог %ProgramFiles%\Crypto Pro\SDK\lib\.
Для платформы x64 cades.lib устанавливается в каталог %ProgramFiles%\Crypto Pro\SDK\lib\amd64\.

Установка (Unix)

Установите дистрибутив c совместимой версией КриптоПро CSP.
Установите пакет cprocsp-pki-cades*.

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

Для использования интерфейса языка С необходимо:

Для работы с CAdES включить в код приложения заголовочный файл cades.h, входящий в состав SDK.
C/C++
```
#include <cades.h>
```
Для работы с XAdES включить в код приложения заголовочный файл xades.h, входящий в состав SDK.
C/C++
```
#include <xades.h>
```

Для работы с CAdES компоновать приложение с указанием дополнительной библиотеки импорта cades.lib.
Для работы с XAdES компоновать приложение с указанием дополнительной библиотеки импорта xades.lib.
Для работы с CAdES включить в ресурсы приложения манифест, описывающий зависимость от cades.dll.
Для работы с XAdES включить в ресурсы приложения манифест, описывающий зависимость от xades.dll. Если вы используете Visual Studio 2005 и выше, то указанный манифест будет добавлен в ресурсы приложения автоматически. Если же вы используете более раннюю версию, то следуйте инструкциям, изложенным в статье Загрузка cades.dll в приложение пользователя.

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

Для использования интерфейса языка С необходимо:

Для работы с CAdES включить в код приложения заголовочный файл cades.h, входящий в состав SDK.
C/C++
```
#include <cades.h>
```
Для работы с XAdES включить в код приложения заголовочный файл xades.h, входящий в состав SDK.
C/C++
```
#include <xades.h>
```

Для работы с CAdES компоновать приложение с библиотекой libcades.so.
Для работы с XAdES компоновать приложение с библиотекой libxades.so.

Установка библиотеки cades.dll/xades.dll на компьютере пользователя (Windows)

Для установки библиотеки cades.dll/xades.dll на компьютере пользователя рекомендуется использовать модули слияния. Если Ваше приложение не имеет собственного установочного пакета, то можно воспользоваться пакетами Windows Installer cades-win32.msi или cades-x64.msi в зависимости от платформы Вашего приложения.

В зависимости от операционной системы, на которую устанавливается библиотека cades.dll/xades.dll инструментария, возможно различное поведение установщика:

Windows XP и выше
На ОС версий Windows XP и выше для изоляции библиотек DLL инструментария используется технология side-by-side. При этом библиотеки DLL устанавливаются в подкаталог каталога %WinDir%\WinSxS\.

Подробнее о технологии изоляции side-by-side можно прочитать в Microsoft Platform SDK .
До Windows XP
На ОС версий ниже Windows XP необходимо устанавливать библиотеки DLL КриптоПро ЭЦП SDK в папку Вашего приложения. О том, как это сделать, смотрите раздел Использование модулей слияния настоящего руководства.

Такой подход к установке позволяет изолировать ваше приложение, использующее функции КриптоПро ЭЦП SDK. Если другое приложение, содержащее в своём составе библиотеки КриптоПро ЭЦП SDK других версий, будет установлено на один компьютер с Вашим приложением, то оба приложения будут использовать те версии библиотек, с которыми они разрабатывались и тестировались, а влиять друг на друга они не будут.

Установка библиотеки libcades.so/libxades.so на компьютере пользователя (Unix)

Установите совместимую версию КриптоПро CSP и пакет cprocsp-pki-cades*, подходящий для Вашей ОС.