Page tree
Skip to end of metadata
Go to start of metadata

Функция(метод) GrdPI_GetCounter возвращает значение счетчика запусков алгоритма или защищённой ячейки.

    int GRD_API GrdPI_GetCounter(
      HANDLE hGrd,			
      DWORD dwItemNum,		
      DWORD *pdwCounter,		
      void	*pReserved		
    );	
     Параметры функции

    hGrd

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

    dwItemNum

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

    pdwCounter

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

    pReserved

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

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

    GrdE_OK

    нет ошибок

    GrdE_NeedInitialization

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

    GrdE_InvalidHandle

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

    GrdE_NoService

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

    GrdE_InvalidArg

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

     Описание

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

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

    public static GrdE GrdPI_GetCounter(Handle grdHandle,GrdAlgNum algNum, out uint counter)
    
    
     Параметры метода

    grdHandle [in] 

    Тип: Handle

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

    algNum [in] 

    Тип: GrdAlgNum

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

    counter [out]

    Тип: uint

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

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

    GrdE.OK

    нет ошибок

    GrdE.NeedInitialization

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

    GrdE.InvalidHandle

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

    GrdE.NoService

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

    GrdE.InvalidArg

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

     Описание

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

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

     public static GrdE GrdPI_GetCounter(Handle grdHandle, int algoNum, int[] counter)
     Параметры метода

    grdHandle [in] 

    Тип: Handle

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

    algNum [in] 

    Тип: int

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

    counter [out]

    Тип: int [ ]

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

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

    GrdE.OK

    нет ошибок

    GrdE.NeedInitialization

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

    GrdE.InvalidHandle

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

    GrdE.NoService

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

    GrdE.InvalidArg

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

     Описание

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

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

    • No labels