Page History

...

Deck of Cards

id	001

Card

default	true
label	C

Code Block

language	cpp

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	для данного типа ячейки не предусмотрена активация
Стандартный набор ошибок

Wiki Markup

Card

label	C#

Code Block

language	c#

public static GrdE

{dojo-tabs:theme=tundra|id=1} {dojo-tab:title=C|selected=true} *C* int GRD_API

 GrdPI_Activate(

HANDLE hGrd, DWORD dwItemNum, DWORD dwActivatePsw ); {dojo-tab} {dojo-tab:title=C#|selected=true} *C#* {dojo-tab} {dojo-tab:title=Visual Basic (Declaration)} *Visual Basic* {dojo-tab} {dojo-tab:title=Visual C++} *Visual C++* {dojo-tab} {dojo-tabs}

Expand

title	Входные параметры

hGrd	хэндл защищенного контейнера для выполнения активации
dwItemNum	номер аппаратного алгоритма или защищенной ячейки для активации
dwActivatePsw	пароль для активации. Если пароль не используется, параметр должен быть равен 0

Expand

title	Выходные параметры

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

GrdE_AccessDenied	неверный пароль активации, доступ к ячейке запрещен
GrdE_StatusUnchangeable	достигнут лимит количества ошибок, статус ячейки изменить нельзя
GrdE_NoService	для данного типа ячейки не предусмотрена активация
	Стандартный набор ошибок

Handle grdHandle,GrdAlgNum algNum, uint activatePsw)

Expand

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

Expand

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

Card

label	Java

Code Block

language	java

Expand

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

Expand

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

Expand

title	Описание

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

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

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

Expand

title	Пример

Пример для используемого средства разработки см. в директории:

"\%Program Files%\Guardant\Guardant 6\%PublicCode%\Samples\x86\Win32\General Guardant API\"
или
"\%Program Files%\Guardant\Guardant 6\%Public Code%\Samples\x64\Win64\General Guardant API\"

Page tree

Versions Compared

Old Version 4

New Version 5

Key