Функции 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 | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Категории файлов | Каталог с API |
Заголовочные файлы | Guardant\Guardant %#%%PublicCode%\Include |
Библиотеки и объектные модули | Guardant\Guardant %#%%PublicCode%\Lib |
Примеры работы с Guardant API | Guardant\Guardant %#%%PublicCode%\Samples| |
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Функции Guardant API, предназначенные для работы с электронными ключами, могут возвращать следующие коды ошибок:
...