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

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

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

Назначение Имя файла
Заголовочный файл cades.h
Библиотека импорта cades.lib - для платформ Win32 и x64 (только для Windows)
Динамическая библиотека

cades.dll - для платформ Win32 и x64 (Windows)

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

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

cades-win32.msi, cades-x64.msi (Windows)

*cades*.rpm (Unix)

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

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

  2. Если Вы планируете запускать 64-разрядное приложение, то установите на Ваш компьютер 64-разрядный КриптоПро ЭЦП Runtime (cades-x64.msi).

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

  4. Убедитесь, что переменная окружения 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)

  1. Установите дистрибутив c совместимой версией КриптоПро CSP.

  2. Установите пакет cprocsp-pki-*-cades*.

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

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

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

    C/C++
    #include <cades.h>
    

  • Компоновать приложение с указанием дополнительной библиотеки импорта cades.lib.

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

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

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

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

    C/C++
    #include <cades.h>
    

  • Компоновать приложение с библиотекой libcades.so.

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

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

В зависимости от операционной системы, на которую устанавливается библиотека cades.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 на компьютере пользователя (Unix)

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