- Created by Dyakov Alexey, last modified by Guardant R&D on Oct 13, 2014
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 8 Next »
Функция GrdPI_Deactivate деактивирует аппаратный алгоритм или защищенную ячейку.
int GRD_API GrdPI_Deactivate( HANDLE hGrd, DWORD dwItemNum, DWORD dwDeactivatePsw );
hGrd |
хэндл защищенного контейнера для выполнения деактивации |
dwItemNum |
номер аппаратного алгоритма или защищенной ячейки для деактивации |
dwDeactivatePsw |
пароль для дективации. Если пароль не используется, параметр должен быть равен 0 |
Возможные ошибки
неверный пароль деактивации, доступ к ячейке запрещен |
|
достигнут лимит количества ошибок, статус ячейки изменить нельзя |
|
для данного типа ячейки не предусмотрена деактивация |
|
Функция GrdPI_Deactivate деактивирует аппаратный алгоритм или любую другую защищенную ячейку. Деактивацию ячейки можно производить в том случае, когда она была создана активной или была активирована через GrdPI_Activate. Для деактивации можно потребовать указать пароль активации dwDeactivatePsw, который задается при создании ячейки или алгоритма. При создании ячейки в GRDUTIL пароль требуется по умолчанию.
Если алгоритм или ячейка находятся в деактивированном состоянии, функция возвращает GrdE_OK вне зависимости от правильности пароля деактивации.
Если при попытке деактивации активной ячейки был указан неверный пароль dwDeactivatePsw, функция GrdPI_Deactivate возвращает ошибку GrdE_AccessDenied. При этом автоматически в ключе уменьшается счетчик ошибок доступа к ячейке, который задается при создании ячейки. Когда значение счетчика ошибок доходит до 0, статус ячейки становится неизменяемым, то есть ячейку больше невозможно активировать/деактивировать/читать/менять ее значение. Однако если алгоритм находился в состоянии Active, функция GrdTransform будет нормально работать.
public static GrdE GrdPI_Deactivate(Handle grdHandle,GrdAlgNum algNum, uint deactivatePsw)
Возможные ошибки
неверный пароль деактивации, доступ к ячейке запрещен |
|
достигнут лимит количества ошибок, статус ячейки изменить нельзя |
|
для данного типа ячейки не предусмотрена деактивация |
|
Метод GrdPI_Deactivate деактивирует аппаратный алгоритм или любую другую защищенную ячейку. Деактивацию ячейки можно производить в том случае, когда она была создана активной или была активирована через GrdPI_Activate. Для деактивации можно потребовать указать пароль активации deactivatePsw, который задается при создании ячейки или алгоритма. При создании ячейки в GRDUTIL пароль требуется по умолчанию.
Если алгоритм или ячейка находятся в деактивированном состоянии, метод возвращает GrdE.OK вне зависимости от правильности пароля деактивации.
Если при попытке деактивации активной ячейки был указан неверный пароль deactivatePsw, метод GrdPI_Deactivate возвращает ошибку GrdE.AccessDenied. При этом автоматически в ключе уменьшается счетчик ошибок доступа к ячейке, который задается при создании ячейки. Когда значение счетчика ошибок доходит до 0, статус ячейки становится неизменяемым, то есть ячейку больше невозможно активировать/деактивировать/читать/менять ее значение. Однако если алгоритм находился в состоянии Active, функция GrdTransform будет нормально работать.
public static GrdE GrdPI_Deactivate(Handle grdHandle, int itemNum, int deactivatePsw)
grdHandle [in]
Тип: Handle
Нэндл защищенного контейнера для выполнения деактивации.
itemNum [in]
Тип: int
Номер аппаратного алгоритма или защищенной ячейки для деактивации.
deactivatePsw [in]
Тип: int
Пароль для деактивации.
Возможные ошибки
неверный пароль деактивации, доступ к ячейке запрещен |
|
достигнут лимит количества ошибок, статус ячейки изменить нельзя |
|
для данного типа ячейки не предусмотрена деактивация |
|
Метод GrdPI_Deactivate деактивирует аппаратный алгоритм или любую другую защищенную ячейку. Деактивацию ячейки можно производить в том случае, когда она была создана активной или была активирована через GrdPI_Activate. Для деактивации можно потребовать указать пароль активации deactivatePsw, который задается при создании ячейки или алгоритма. При создании ячейки в GRDUTIL пароль требуется по умолчанию.
Если алгоритм или ячейка находятся в деактивированном состоянии, метод возвращает GrdE.OK вне зависимости от правильности пароля деактивации.
Если при попытке деактивации активной ячейки был указан неверный пароль deactivatePsw, метод GrdPI_Deactivate возвращает ошибку GrdE.AccessDenied. При этом автоматически в ключе уменьшается счетчик ошибок доступа к ячейке, который задается при создании ячейки. Когда значение счетчика ошибок доходит до 0, статус ячейки становится неизменяемым, то есть ячейку больше невозможно активировать/деактивировать/читать/менять ее значение. Однако если алгоритм находился в состоянии Active, функция GrdTransform будет нормально работать.
- No labels