Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Функции Guardant API общего назначения

Функции общего назначения позволяют осуществлять сервисные операции, связанные с инициализацией, настройкой и деинициализацией Guardant API, а также выполнять основные операции с электронными ключами:

...

Название функции

Код доступа

Краткое описание

GrdStartup

Не нужен

Инициализировать Guardant API

GrdStartupEx

Не нужен

Инициализировать GrdAPI + задать путь к GnClient.ini

GrdCleanup

Не нужен

Деинициализировать Guardant API

GrdDllMain

Не нужен

Инициализировать сетевые функции для использования в DLL

GrdGetLastError

Не нужен

Получить информацию о последней ошибкеиз защищенного контейнера

GrdFormatMessage

Не нужен

Преобразовать код ошибки в текстовое сообщение

GrdGetInfo

Не нужен

Получить информацию из защищенного контейнера

GrdIsValidHandle

Не нужен

Проверить валидность хэндла защищенногоконтейнера

GrdCreateHandle

Не нужен

Создать хэндл защищенного контейнера

GrdCloseHandle

Не нужен

Закрыть хэндл защищенного контейнера

GrdSetAccessCodes

Public и Read обязательно, остальные по необходимости

Поместить коды доступа в защищенный контейнер

GrdSetWorkMode

Не нужен

Установить режимы работы Guardant API

GrdSetFindMode

Не нужен

Установить режимы поиска электронных ключей

GrdFind

Private Read

Найти электронный ключ, удовлетворяющий критериям поиска

GrdLogin

Private Read

Зарегистрироваться на электронном ключе

GrdLogout

Private Read

Снять регистрацию с электронного ключа

GrdLock

Private Read

Заблокировать ключ на время выполнения операций, требующих монопольного режима работы с ключом

GrdUnlock

Private Read

Разблокировать электронный ключ

GrdCheck

Private Read

Проверить наличие электронного ключа

GrdDecGP

Private Read+ PrivateWrite

Декрементировать счетчик GP

GrdRead

Private Read

Прочитать данные из памяти электронного ключа

GrdWrite

Private Write

Записать данные в память электронного ключа

GrdSign

Private Read

Вычислить ЭЦП массива данных

GrdVerifySign

Не нужен

Проверить ЭЦП массива данных

GrdSeek

Не нужен

Переместить указатель на текущий адрес памятиэлектронного ключа

GrdInit

Private master

Инициализировать память электронного ключа

GrdProtect

Private master

Установить аппаратные запреты чтения/записи и записать количество аппаратных алгоритмов и защищенных ячеек

GrdTransform

Private Read

Преобразовать данные аппаратно- или программно-реализованным алгоритмом

GrdTransformEx

Private Read

Преобразовать данные аппаратно- или программно-реализованным алгоритмом

GrdCrypt

Private Read

Закодировать/раскодировать данные аппаратноили программно-реализованным алгоритмом

GrdCryptEx

Private Read

Закодировать/раскодировать данные аппаратноили программно-реализованным алгоритмом

GrdHash

Private Read

Вычислить значение хэш-функции программноили аппаратно-реализованным алгоритмом

GrdHashEx

Private Read

Расширенный вариант GrdHash

GrdCodeInit

PrivateRead

Инициализировать пароль быстрого взаимообратного преобразования

GrdEnCode

не нужен

Закодировать данные быстрым взаимообратнымпреобразованием

GrdDeCode

не нужен

Раскодировать данные быстрым взаимообратнымпреобразованием

GrdCRC

не нужен

Вычислить CRC

Функции Guardant API для работы с защищенными ячейками

Для работы с защищенными ячейками существуют специальные функции Guardant API:

Название функции

Код доступа

Краткое описание

GrdPI_Activate

Private Readи пароль на данную операцию, если он задан в ключе

Активировать алгоритм / защищенную ячейку

GrdPI_Deactivate

 

Деактивировать аппаратный алгоритмили защищенную ячейку

GrdPI_Read

 

Прочитать данные из защищенной ячейки

GrdPI_Update

 

Обновить данные в защищенной ячейке

GrdPI_GetCounter

 

Получить значение счетчика запусков алгоритма

Функции Guardant API для работы с ключами с RTC

Для работы с ключами, поддерживающими технологию Time, существуют специальные функции Guardant API:

Название функции

Код доступа

Краткое описание

GrdSetTime

Private Master

Установить время микросхемы таймера ключа

GrdGetTime

Private Read

Получить время таймера ключа

GrdPI_GetTimeLimit

Private Read

Получить оставшееся время работы алгоритма

GrdMakeSystemTime

Не нужен

Заполнить поля структуры TgrdSystemTime

GrdSplitSystemTime

Не нужен

Получить значение полей структуры TgrdSystemTime

GrdTRU_ GenerateQuestionTime

Private Read

Сгенерировать зашифрованное число-вопрос

GrdTRU_GenerateQuestionTimeEx

Private Read

Расширенная версия GrdTRU_GenerateQuestionTime

GrdTRU_ DecryptQuestionTime

Private Read

Расшифровать и проверить подлинностьчисла-вопроса

GrdTRU_DecryptQuestionTimeEx

Private Read

Расширенная версия GrdTRU_ DecryptQuestionTime

Функции Guardant API для работы с Trusted Remote Update

Технология удаленного обновления Trusted Remote Update может быть реализована не только при помощи утилит, входящих в Комплект разработчика. При желании разработчики могут встраивать поддержку этой технологии непосредственно в свои приложения, используя набор предназначенных для этой цели функций:

Название функции

Код доступа

Краткое описание

GrdTRU_SetKey

Private Master

Инициализировать память электронного ключа и записать секретный ключ TRU

GrdTRU_GenerateQuestion

Private Read

Сгенерировать число-вопрос

GrdTRU_GenerateQuestionEx

Private Read

Расширенная версия GrdTRU_GenerateQuestion

GrdTRU_DecryptQuestion

Private Read

Декодировать и проверить подлинность числа-вопроса

GrdTRU_DecryptQuestionEx

Private Read

Расширенная версия GrdTRU_DecryptQuestion

GrdTRU_SetAnswerProperties

Не нужен

Установить параметры числа-ответа

GrdTRU_EncryptAnswer

Private Read

Сгенерировать и кодировать число-ответ

GrdTRU_EncryptAnswerEx

Private Read

Расширенная версия GrdTRU_EncryptAnswer

GrdTRU_ApplyAnswer

Private Read

Записать число-ответ в ключ Guardant

 

Функции Guardant API для работы с ключами Guardant Code

См. Сервисные функции для работы с загружаемым кодом.

Внутреннее Guardant API Code для загружаемого кода

См. Guardant Code API.

Функции Guardant API для управления драйверами

Для того чтобы инсталлировать, деинсталлировать и настраивать драйверы Guardant из собственных приложений можно использовать функции управления драйверами, которые реализованы в виде динамически загружаемой библиотеки.

...

Anchor
_Toc463859374
_Toc463859374
Anchor
_Toc485195598
_Toc485195598
Anchor
_Toc493314288
_Toc493314288
Anchor
_Toc493322590
_Toc493322590
Anchor
_Toc493322726
_Toc493322726
Anchor
_Toc495289498
_Toc495289498
Anchor
_Toc20393166
_Toc20393166
Anchor
_Toc101339678
_Toc101339678
Anchor
_Toc131421571
_Toc131421571
Anchor
_Toc140561740
_Toc140561740

Anchor
_Toc260939205
_Toc260939205
Anchor
_Toc326167600
_Toc326167600
Местонахождение файлов API
Anchor
_Hlt101339644
_Hlt101339644

Категории файлов

Каталог с API

Заголовочные файлы

Guardant\Guardant %#%%PublicCode%\Include

Библиотеки и объектные модули

Guardant\Guardant %#%%PublicCode%\Lib

Примеры работы с Guardant API

Guardant\Guardant %#%%PublicCode%\Samples|

Anchor
_Toc485195599
_Toc485195599
Anchor
_Ref491491879
_Ref491491879
Anchor
_Toc493314289
_Toc493314289
Anchor
_Toc493322591
_Toc493322591
Anchor
_Toc493322727
_Toc493322727
Anchor
_Toc495289499
_Toc495289499
Anchor
_Toc20393167
_Toc20393167
Anchor
_Toc101339679
_Toc101339679
Anchor
_Toc131421572
_Toc131421572
Anchor
_Toc140561741
_Toc140561741
Anchor
_Toc260939206
_Toc260939206
Anchor
_Toc326167601
_Toc326167601
Коды ошибок Guardant API

Функции Guardant API, предназначенные для работы с электронными ключами, могут возвращать следующие коды ошибок:

...