GrdSign

Функция(метод) GrdSign вычисляет электронную цифровую подпись входного сообщения при помощи аппаратно-реализованного алгоритма ECC160.

int GRD_API GrdSign(
  HANDLE hGrd,			
  DWORD	dwAlgoNum,		
  DWORD	dwDataLng,		
  void *pData,			
  DWORD	dwSignResultLng,
  void *pSignResult,	
  void *pReserved
);

hGrd [in]	хэндл, через который будет выполнена данная операция
dwAlgoNum [in]	числовое имя аппаратного алгоритма электронной цифровой подписи
dwDataLng [in]	длина входного сообщения (20 байт для ECC160)
pData [in]	указатель на входное сообщение
dwSignResultLng [in]	длина выходного буфера для электронной цифровой подписи (40 байт для ECC160)
pSignResult [out]	указатель на выходной буфер, в который будет сохранена электронная цифровая подпись
pReserved	зарезервировано

GrdE_OK	нет ошибок
GrdE_InvalidArg	недопустимый параметр при вызове функции
GrdE_NoService	для алгоритма/ячейки сервис не предусмотрен
GrdE_AlgoNotFound	алгоритма с указанным числовым именем не существует
GrdE_GPis0	счетчик алгоритма достиг нулевого значения

Функция GrdSign позволяет вычислить электронно-цифровую подпись (ЭЦП) входного сообщения при помощи аппаратного алгоритма ЭЦП. Вычисление выполняется алгоритмом с числовым именем, заданным в параметре dwAlgoNum. Этот алгоритм предварительно должен быть создан, в противном случае возвращается ошибка GrdE_AlgoNotFound. Если в дескрипторе алгоритма установлен флаг "уменьшение счетчика", то вычитание счетчика алгоритма происходит при каждом вызове GrdSign. При достижении счетчиком нулевого значения, возвращается ошибка GrdE_GPis0. Если при создании алгоритма или в процессе работы он был переведен в неактивное состояние, возвращается ошибка GrdE_InactiveItem. При попытке вызвать функцию для моделей ключей Stealth II или Stealth III, возвращается ошибка GrdE_NoService.

Длина входного сообщения задаётся параметром dwDataLng. Сообщение для подписи должно находиться по адресу, указанному в параметре pData. Буфер для ЭЦП должен быть зарезервирован заранее, а его длина передана функции через параметр dwSignResultLng. Если один из указателей равен NULL или неверно заданы длины входного сообщения и выходного буфера ЭЦП, функция возвращает GrdE_InvalidArg. В случае успешного выполнения, по адресу pSignResult будет находится вычисленная ЭЦП от входного сообщения, при этом функция возвращает GrdE_OK. Для алгоритма ECC160 длина входного сообщения и длина возвращаемой электронной цифровой подписи должны быть GrdECC160_MESSAGE_SIZE и GrdECC160_DIGEST_SIZE соответственно.

public static GrdE GrdSign(Handle grdHandle, GrdAlgNum algNum, byte[] data, out byte[] digestSign)

grdHandle [in]

Тип: Handle

Хэндл, через который будет выполнена данная операция.

algNum [in]

Тип: GrdAlgNum

Числовое имя аппаратного алгоритма электронной цифровой подписи.

data [in]

Тип: byte [ ]

Входное сообщение для подписи.

digestSign [out]

Тип: byte [ ]

Выходной буфер, в который будет сохранена электронная цифровая подпись.

GrdE.OK	нет ошибок
GrdE.InvalidArg	недопустимый параметр при вызове функции
GrdE.NoService	ключ не поддерживает данную функцию
GrdE.AlgoNotFound	алгоритма с указанным числовым именем не существует
GrdE.GPis0	счетчик алгоритма достиг нулевого значения

Метод GrdSign позволяет вычислить электронно-цифровую подпись (ЭЦП) входного сообщения при помощи аппаратного алгоритма ЭЦП. Вычисление выполняется алгоритмом с числовым именем, заданным в параметре dwAlgoNum. Этот алгоритм предварительно должен быть создан, в противном случае возвращается ошибка GrdE.AlgoNotFound. Если в дескрипторе алгоритма установлен флаг "уменьшение счетчика", то вычитание счетчика алгоритма происходит при каждом вызове GrdSign. При достижении счетчиком нулевого значения, возвращается ошибка GrdE.GPis0. Если при создании алгоритма или в процессе работы он был переведен в неактивное состояние, возвращается ошибка GrdE.InactiveItem. При попытке вызвать метод для моделей ключей Stealth II или Stealth III, возвращается ошибка GrdE.NoService.

Сообщение для подписи должно находиться в массиве data. Буфер для ЭЦП должен быть зарезервирован заранее и передан методу через параметр digestSign. Если длины массивов входного сообщения или выходного буфера ЭЦП заданы неверно, метод возвращает GrdE.InvalidArg. В случае успешного выполнения, в массиве digestSign будет находится вычисленная ЭЦП от входного сообщения, при этом метод возвращает GrdE.OK. Для алгоритма ECC160 длина входного сообщения и длина возвращаемой электронной цифровой подписи должны быть GrdECC160.MESSAGE_SIZE и GrdECC160.DIGEST_SIZE соответственно.

 public static GrdE GrdSign(Handle grdHandle, int algNum, byte[] data, byte[] sign)

grdHandle [in]

Тип: Handle

хэндл, через который будет выполнена данная операция.

algNum [in]

Тип: int

Числовое имя аппаратного алгоритма.

data [in]

Тип: byte [ ]

Указатель на массив данных.

sign [out]

Тип: byte [ ]

Указатель на массив цифровой подписи.

GrdE.OK	нет ошибок
GrdE.NeedInitialization	требуется инициализация API (вызов GrdStartup)
GrdE.InvalidHandle	недействительный хэндл
GrdE.InvalidArg	недопустимый параметр при вызове функции
GrdE.NoService	ключ не поддерживает данную функцию
GrdE.AlgoNotFound	алгоритма с указанным числовым именем не существует
GrdE.CRCErrorFunc	ошибка CRC при выполнении функции
GrdE.GPis0	счетчик алгоритма достиг нулевого значения

Метод GrdSign позволяет вычислять цифровую подпись массива данных при помощи аппаратного алгоритма типа ECC. Вычисление цифровой подписи выполняется алгоритмом с числовым именем, заданным в параметре algNum. Этот алгоритм предварительно должен быть создан, в противном случае возвращается ошибка GrdE.AlgoNotFound. Если в дескрипторе алгоритма установлен флаг "уменьшение счетчика", то вычитание счетчика алгоритма происходит при каждом вызове GrdSign. При достижении счетчиком нулевого значения, возвращается ошибка GrdE.GPis0. Если при создании алгоритма или в процессе работы он был переведен в неактивное состояние, возвращается ошибка GrdE.InactiveItem. Ссылка на массив данных указана в параметре data. Возвращаемая цифровая подпись находится в массиве sign. Для алгоритма ECC160 длина массива данных и длина возвращаемой цифровой подписи должны быть GrdECC160.MESSAGE_SIZE (20 байт) и GrdECC160.DIGEST_SIZE (40 байт) соответственно.

Page tree

GrdSign