Versions Compared

Key

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

...

Deck of Cards
id001
Card
defaulttrue
labelC
Code Block
languagecpp
int  GcaPI_GetCounter(
  HANDLE	 hGrd,			
  DWORD	dwItemNum,		
  DWORD	*pdwCounter,		
  void	 *pReserved		
);	
Expand
titleПараметры функции

hGrd

не используется

dwItemNum

числовое имя аппаратного алгоритма/защищенной ячейки

pdwCounter

указатель на буфер для передачи значения счетчика

pReserved

зарезервировано, должно быть равно NULL

Expand
titleВозвращаемое значение функции

GrdE_OK

нет ошибок

GrdE_NeedInitialization

требуется инициализация API (вызов GrdStartup)

GrdE_InvalidHandle

недействительный хэндл

GrdE_NoService

для алгоритма/ячейки сервис не предусмотрен

GrdE_InvalidArg

недопустимый параметр при вызове функции

Expand
titleОписание
Функция GcaPI_GetCounter возвращает значение счетчика запусков алгоритма или защищённой ячейки. Числовое имя алгоритма или защищённой ячейки задается параметром dwItemNum. Если счетчик запусков алгоритма не используется (флаг nsafl_GP_dec либо nsafl_GP поля LoFlags дескриптора алгоритма), возвращается ошибка GrdE_NoService.

...