- Created by Dyakov Alexey, last modified by Guardant R&D on Oct 06, 2014
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 9 Next »
Функция GrdPI_Activate активирует аппаратный алгоритм или защищенную ячейку.
int GRD_API GrdPI_Activate( HANDLE hGrd, DWORD dwItemNum, DWORD dwActivatePsw );
hGrd |
хэндл защищенного контейнера для выполнения активации |
dwItemNum |
номер аппаратного алгоритма или защищенной ячейки для активации |
dwActivatePsw |
пароль для активации. Если пароль не используется, параметр должен быть равен 0 |
Возможные ошибки
GrdE_AccessDenied |
неверный пароль активации, доступ к ячейке запрещен |
GrdE_StatusUnchangeable |
достигнут лимит количества ошибок, статус ячейки изменить нельзя |
GrdE_NoService |
для данного типа ячейки не предусмотрена активация |
Функция 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)
Возможные ошибки
GrdE_AccessDenied |
неверный пароль активации, доступ к ячейке запрещен |
GrdE_StatusUnchangeable |
достигнут лимит количества ошибок, статус ячейки изменить нельзя |
GrdE_NoService |
для данного типа ячейки не предусмотрена активация |
Функция GrdPI_Activate активирует аппаратный алгоритм или любую другую защищенную ячейку. Активацию ячейки можно производить в том случае, когда она была создана неактивной, либо была деактивирована через GrdPI_Deactivate. Для активации можно потребовать указать пароль активации dwActivatePsw, который задается при создании ячейки или алгоритма. При создании ячейки в GRDUTIL пароль требуется по умолчанию.
Если алгоритм или ячейка находятся в активном состоянии (Active), функция возвращает GrdE_OK вне зависимости от правильности пароля активации.
Если при попытке активации неактивной ячейки был указан неверный пароль dwActivatePsw, функция 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
Пароль для активации.
Возможные ошибки
GrdE_AccessDenied |
неверный пароль активации, доступ к ячейке запрещен |
GrdE_StatusUnchangeable |
достигнут лимит количества ошибок, статус ячейки изменить нельзя |
GrdE_NoService |
для данного типа ячейки не предусмотрена активация |
Функция GrdPI_Activate активирует аппаратный алгоритм или любую другую защищенную ячейку. Активацию ячейки можно производить в том случае, когда она была создана неактивной, либо была деактивирована через GrdPI_Deactivate. Для активации можно потребовать указать пароль активации dwActivatePsw, который задается при создании ячейки или алгоритма. При создании ячейки в GRDUTIL пароль требуется по умолчанию.
Если алгоритм или ячейка находятся в активном состоянии (Active), функция возвращает GrdE_OK вне зависимости от правильности пароля активации.
Если при попытке активации неактивной ячейки был указан неверный пароль dwActivatePsw, функция GrdPI_Activate возвращает ошибку GrdE_AccessDenied. При этом автоматически в ключе уменьшается счетчик ошибок доступа к ячейке, который задается при создании ячейки. Когда значение счетчика ошибок доходит до 0, статус ячейки становится неизменяемым, то есть ячейку больше невозможно активировать/деактивировать/читать/менять ее значение. Однако если алгоритм находился в состоянии Active, функция GrdTransform будет нормально работать.
- No labels