Page History

...

Deck of Cards

id	001

Card

default	true
label	C

Code Block

language	cpp

int GRD_API GrdPI_GetCounter(
  HANDLE HANDLE	hGrd,			
  DWORD DWORD	dwItemNum,		
  DWORD 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	Описание

Функция GrdPI_GetCounter возвращает значение счетчика запусков алгоритма или защищённой ячейки. Числовое имя алгоритма или защищённой ячейки задается параметром dwItemNum. Для работы требуется предварительно установить Private Read Code при помощи функции GrdSetAccessCodes. Если счетчик запусков алгоритма не используется (флаг nsafl_GP_dec либо nsafl_GP поля LoFlags дескриптора алгоритма), возвращается ошибка GrdE_NoService.

Поддерживается ключами, начиная с поколения Guardant Sign/Time.

Card

label	C#

Code Block

language	c#

public static GrdE GrdPI_GetCounter(Handle grdHandle,GrdAlgNum algNum, out uint counter)

Expand

title	Параметры метода

grdHandle [in]

Тип: Handle

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

algNum [in]

Тип: GrdAlgNum

Номер (числовое имя) аппаратного алгоритма или защищенной ячейки.

counter [out]

Тип: uint

Указатель на буфер, где находится значение счетчика.

Expand

title	Возвращаемое значение метода

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

Expand

title	Описание

Метод GrdPI_GetCounter возвращает значение счетчика запусков алгоритма или защищённой ячейки. Числовое имя алгоритма или защищённой ячейки задается параметром algNum. Для работы требуется предварительно установить Private Read Code при помощи метода GrdSetAccessCodes. Если счетчик запусков алгоритма не используется (флаг nsafl_GP_dec либо nsafl_GP поля LoFlags дескриптора алгоритма), возвращается ошибка GrdE.NoService.

Поддерживается ключами, начиная с поколения Guardant Sign/Time.

Card

label	Java

Code Block

language	java

 public static GrdE GrdPI_GetCounter(Handle grdHandle, int algoNum, int[] counter)

Expand

title	Параметры метода

grdHandle [in]

Тип: Handle

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

algNum [in]

Тип: int

Номер (числовое имя) аппаратного алгоритма или защищенной ячейки.

counter [out]

Тип: int [ ]

Указатель на буфер, где находится значение счетчика.

Expand

title	Возвращаемое значение метода

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

Expand

title	Описание

Метод GrdPI_GetCounter возвращает значение счетчика запусков алгоритма или защищённой ячейки. Числовое имя алгоритма или защищённой ячейки задается параметром algNum. Для работы требуется предварительно установить Private Read Code при помощи метода GrdSetAccessCodes. Если счетчик запусков алгоритма не используется (флаг nsafl_GP_dec либо nsafl_GP поля LoFlags дескриптора алгоритма), возвращается ошибка GrdE.NoService.

Поддерживается ключами, начиная с поколения Guardant Sign/Time.

Page tree

Versions Compared

Old Version 12

New Version Current

Key