Versions Compared

Old Version 4

changes.mady.by.user Guardant R&D

Saved on

compared with

New Version Current

changes.mady.by.user Guardant R&D

Saved on

Key

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

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

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

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

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

 

 

 

Wiki Markup
{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}
номер

Набор ошибок Guardant API

Expand
titleОписание

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

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

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

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

grdHandle [in] 

Тип: Handle

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

algNum [in] 

Тип: GrdAlgNum

Номер

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

hGrd

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

dwItemNum

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

dwActivatePsw

.

activatePsw [in]

Тип: uint

Пароль

пароль

для активации.

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

Expand
title
Выходные параметры
Возвращаемое значение функции

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

GrdE

_

.AccessDenied

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

GrdE

_

.StatusUnchangeable

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

GrdE

_

.NoService

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

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

Набор ошибок Guardant API


Expand
titleОписание
Функция

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

dwActivatePsw

activatePsw, который задается при создании ячейки или алгоритма. При создании ячейки в GRDUTIL пароль требуется по умолчанию.

Если алгоритм или ячейка находятся в активном состоянии (Active),

функция

метод возвращает GrdE

_

.OK вне зависимости от правильности пароля активации.

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

dwActivatePsw

activatePsw,

функция

метод GrdPI_Activate возвращает ошибку GrdE

_

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

функция

метод GrdTransform будет нормально работать.

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

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

Набор ошибок Guardant API


Expand
titleОписание

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

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

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

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

"\%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\"