Page History

int GRD_API GrdPI_Activate(	
  HANDLE hGrd,
  DWORD dwItemNum,
  DWORD dwActivatePsw
);	

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

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

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

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

public static GrdE GrdPI_Activate(Handle grdHandle,GrdAlgNum algNum, uint activatePsw)

grdHandle [in] 

Тип: Handle

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

algNum [in] 

Тип: GrdAlgNum

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

activatePsw [in]

Тип: uint

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

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

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

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

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

public static GrdE GrdPI_Activate(Handle grdHandle, int itemNum, int activatePsw)

grdHandle [in] 

Тип: Handle

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

itemNum [in] 

Тип: int

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

activatePsw [in]

Тип: int

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

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

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

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

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