Versions Compared

Old Version 6

changes.mady.by.user Guardant R&D

Saved on

compared with

New Version 7

changes.mady.by.user Guardant R&D

Saved on

Key

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

...

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

hGrd

хэндл защищенного контейнера для выполнения активации

dwItemNum

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

dwActivatePsw

пароль для активации. Если пароль не используется, параметр должен быть равен 0

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

Возможные ошибки

GrdE_AccessDenied

неверный пароль активации, доступ к ячейке запрещен

GrdE_StatusUnchangeable

достигнут лимит количества ошибок, статус ячейки изменить нельзя

GrdE_NoService

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

Стандартный набор ошибок

Card
labelC#
Code Block
languagec#
public static GrdE GrdPI_Activate(Handle grdHandle,GrdAlgNum algNum, uint activatePsw)
Expand
titleПараметры метода

grdHandle [in] 

Тип: Handle

Нэндл защищенного контейнера для выполнения активации.

algNum [in] 

Тип: GrdAlgNum

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

activatePsw [in]

Тип: uint

Пароль для активации.

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

Возможные ошибки

GrdE_AccessDenied

неверный пароль активации, доступ к ячейке запрещен

GrdE_StatusUnchangeable

достигнут лимит количества ошибок, статус ячейки изменить нельзя

GrdE_NoService

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

Стандартный набор ошибок

 


Card
labelJava
Code Block
languagejava
public static GrdE GrdPI_Activate(Handle grdHandle, int itemNum, int activatePsw)
Expand
titleПараметры метода

grdHandle [in] 

Тип: Handle

Нэндл защищенного контейнера для выполнения активации.

itemNum [in] 

Тип: int

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

activatePsw [in]

Тип: int

Пароль для активации.

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

Возможные ошибки

GrdE_AccessDenied

неверный пароль активации, доступ к ячейке запрещен

GrdE_StatusUnchangeable

достигнут лимит количества ошибок, статус ячейки изменить нельзя

GrdE_NoService

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

Стандартный набор ошибок

 


 

 

 

Expand
titleОписание

Функция GrdPI_Activate активирует аппаратный алгоритм или любую другую защищенную ячейку. Активацию ячейки можно производить в том случае, когда она была создана неактивной, либо была деактивирована через GrdPI_Deactivate. Для активации можно потребовать указать пароль активации dwActivatePsw, который задается при создании ячейки или алгоритма. При создании ячейки в GRDUTIL пароль требуется по умолчанию.

Если алгоритм или ячейка находятся в активном состоянии (Active), функция возвращает GrdE_OK вне зависимости от правильности пароля активации.

Если при попытке активации неактивной ячейки был указан неверный пароль dwActivatePsw, функция GrdPI_Activate возвращает ошибку GrdE_AccessDenied. При этом автоматически в ключе уменьшается счетчик ошибок доступа к ячейке, который задается при создании ячейки. Когда значение счетчика ошибок доходит до 0, статус ячейки становится неизменяемым, то есть ячейку больше невозможно активировать/деактивировать/читать/менять ее значение. Однако если алгоритм находился в состоянии Active, функция GrdTransform будет нормально работать.