int GRD_API GrdLock(
HANDLE hGrd,
DWORD dwTimeoutWaitForUnlock,
DWORD dwTimeoutAutoUnlock,
DWORD dwMode
); |
hGrd | хэндл, через который будет выполнена данная операция | dwTimeoutWaitForUnlock | таймаут, определяющий максимальный интервал времени в миллисекундах, в течении которого функция будет ожидать разблокирования ключа. Параметр используется для того, чтобы не организовывать циклы ожидания разблокирования ключа другим приложением. Если dwTimeoutWaitForUnlock равен 0xFFFFFFFF, ожидание будет происходить неограниченно долго. Если dwTimeoutWaitForUnlock равен 0, == no waiting | dwTimeoutAutoUnlock | параметр задает интервал времени в миллисекундах, на которое блокируется ключ. По истечении этого времени, если ключ не был разблокирован функцией GrdUnlock, драйвер снимает блокировку с ключа автоматически. Если dwTimeoutAutoUnlock равен 0xFFFFFFFF, время блокирования не ограничено и блокировка может быть снята только функцией GrdUnlock. Если dwTimeoutAutoUnlock равен 0, время блокирования устанавливается равным 10000 мс (10 секунд). Этого времени должно с запасом хватить на выполнения блока несложных операций типа - чтения данных/их модификации/запись назад. Для работы в сети данные таймауты лучше увеличивать так, чтобы за это время максимальное кол-во приложений успело выполнить данный фрагмент кода работы с ключом. Ну или писать код так, чтобы обрабатывать события автоматического разблокирования ключа. | dwMode | комбинация флагов GrdLM_XXXX, определяющих, доступ к каким именно операциям с ключом будет заблокирован GrdLM_Nothing | Блокируется только вызов GrdLock из другого потока, процесса или даже компьютера (при работе в сети) | GrdLM_Init | Блокируются операции Init | GrdLM_Protect | Блокируются операции Protect | GrdLM_Transform | Блокируются операции Transform | GrdLM_Read | Блокируются операции Read | GrdLM_Write | Блокируются операции Write | GrdLM_Activate | Блокируются операции Activate | GrdLM_Deactivate | Блокируются операции Deactivate | GrdLM_ReadItem | Блокируются операции ReadItem | GrdLM_UpdateItem | Блокируются операции UpdateItem | GrdLM_All | Блокируются все перечисленные операции |
|
|
Функция GrdLock блокирует выполнение операций с ключом для всех остальных хэндлов/приложений, работающих с этим же ключом на уровне драйвера. Функция используется в случаях, когда нужно выполнить пакет каких-либо операций, требующих синхронизации. Например обновление какой-либо ячейки памяти или для операций со счетчиками. При выполнении блокирования ключа сначала проверяется, не заблокирован ли он из другого потока или приложения. Эта проверка также осуществляется данной функцией. В том случае, если ключ уже заблокирован, функция ожидает разблокирования ключа в течении таймаута dwTimeoutWaitForUnlock. Если в течении этого таймаута ключ остается заблокированным другим приложением, возвращается ошибка GrdE_DongleBusy. При блокировании операций с ключом задается время dwTimeoutAutoUnlock, на которое выполняется блокировка. Пои истечении этого времени драйвер автоматически разблокирует ключ. Этот таймаут задается разработчиком приложения в зависимости от потребностей. Более длинные операции, такие как считывание и запись больших объемов данных из памяти ключа требуют больше времени, следовательно и таймаут в таких случаях нужно делать больше. Также можно не ограничивать интервал автоматического разблокирования ключа (dwTimeoutAutoUnlock = 0xFFFFFFFF). В таком случае блокировка может быть снята только функцией GrdUnlock. Это потенциально опасно тем, что при зависании приложения потребуется перезагрузка ОС для разблокирования ключа. Операции Login, Check and Find заблокированы быть не могут. На терминал-сервере работа с электронным ключом в разных сессиях идет через один драйвер ключа и соответственно блокировки должны работать так же. Внимание! Пара функций GrdLock и GrdUnlock не рассчитана на вызов из разных потоков. В этом случае, при вызове GrdUnlock из другого потока ключ не будет разблокирован (здесь можно провести аналогию с работой с критическими секциями). |
|
public static GrdE GrdLock(Handle grdHandle, uint timeoutAutoUnlock, uint timeoutWaitForUnlock, GrdLockMode mode)
|
grdHandle [in] Тип: Handle Хэндл, через который будет выполнена данная операция timeoutAutoUnlock [in] Тип: uint Параметр задает интервал времени в миллисекундах, на которое блокируется ключ. По истечении этого времени, если ключ не был разблокирован функцией GrdUnlock, драйвер снимает блокировку с ключа автоматически. timeoutWaitForUnlock [in] Тип: uint Таймаут, определяющий максимальный интервал времени в миллисекундах, в течении которого функция будет ожидать разблокирования ключа. Параметр используется для того, чтобы не организовывать циклы ожидания разблокирования ключа другим приложением. mode [in] Тип: GrdLockMode Комбинация флагов GrdLockMode, которая определяет перечень заблокированных операций с ключом. |
Метод GrdLock блокирует выполнение операций с ключом для всех остальных хэндлов/приложений, работающих с этим же ключом на уровне драйвера. Метод используется в случаях, когда нужно выполнить пакет каких-либо операций, требующих синхронизации. Например обновление какой-либо ячейки памяти или для операций со счетчиками. При выполнении блокирования ключа сначала проверяется, не заблокирован ли он из другого потока или приложения. Эта проверка также осуществляется данным методом. В том случае, если ключ уже заблокирован, метод ожидает разблокирования ключа в течении таймаута timeoutWaitForUnlock. Если в течении этого таймаута ключ остается заблокированным другим приложением, возвращается ошибка GrdE.DongleBusy. При блокировании операций с ключом задается время timeoutAutoUnlock, на которое выполняется блокировка. По истечении этого времени драйвер автоматически разблокирует ключ. Этот таймаут задается разработчиком приложения в зависимости от потребностей. Более длинные операции, такие как считывание и запись больших объемов данных из памяти ключа требуют больше времени, следовательно и таймаут в таких случаях нужно делать больше. Также можно не ограничивать интервал автоматического разблокирования ключа (timeoutAutoUnlock = 0xFFFFFFFF). В таком случае блокировка может быть снята только функцией GrdUnlock. Это потенциально опасно тем, что при зависании приложения потребуется перезагрузка ОС для разблокирования ключа. Операции Login, Check and Find заблокированы быть не могут. На терминал-сервере работа с электронным ключом в разных сессиях идет через один драйвер ключа и соответственно блокировки должны работать так же. Внимание! Пара методов GrdLock и GrdUnlock не рассчитана на вызов из разных потоков. В этом случае, при вызове GrdUnlock из другого потока ключ не будет разблокирован (здесь можно провести аналогию с работой с критическими секциями). |
|
public static GrdE GrdLock(Handle grdHandle, int timeoutAutoUnlock, int timeoutWaitForUnlock, GrdLockMode lockMode) |
grdHandle [in] Тип: Handle Хэндл, через который будет выполнена данная операция timeoutAutoUnlock [in] Тип: int Параметр задает интервал времени в миллисекундах, на которое блокируется ключ. По истечении этого времени, если ключ не был разблокирован функцией GrdUnlock, драйвер снимает блокировку с ключа автоматически. timeoutWaitForUnlock [in] Тип: int Таймаут, определяющий максимальный интервал времени в миллисекундах, в течении которого функция будет ожидать разблокирования ключа. Параметр используется для того, чтобы не организовывать циклы ожидания разблокирования ключа другим приложением. mode [in] Тип: GrdLockMode Комбинация флагов GrdLockMode, которая определяет перечень заблокированных операций с ключом. |
Метод GrdLock блокирует выполнение операций с ключом для всех остальных хэндлов/приложений, работающих с этим же ключом на уровне драйвера. Метод используется в случаях, когда нужно выполнить пакет каких-либо операций, требующих синхронизации. Например обновление какой-либо ячейки памяти или для операций со счетчиками. При выполнении блокирования ключа сначала проверяется, не заблокирован ли он из другого потока или приложения. Эта проверка также осуществляется данным методом. В том случае, если ключ уже заблокирован, метод ожидает разблокирования ключа в течении таймаута timeoutWaitForUnlock. Если в течении этого таймаута ключ остается заблокированным другим приложением, возвращается ошибка GrdE.DongleBusy. При блокировании операций с ключом задается время timeoutAutoUnlock, на которое выполняется блокировка. По истечении этого времени драйвер автоматически разблокирует ключ. Этот таймаут задается разработчиком приложения в зависимости от потребностей. Более длинные операции, такие как считывание и запись больших объемов данных из памяти ключа требуют больше времени, следовательно и таймаут в таких случаях нужно делать больше. Также можно не ограничивать интервал автоматического разблокирования ключа (timeoutAutoUnlock = 0xFFFFFFFF). В таком случае блокировка может быть снята только функцией GrdUnlock. Это потенциально опасно тем, что при зависании приложения потребуется перезагрузка ОС для разблокирования ключа. Операции Login, Check and Find заблокированы быть не могут. На терминал-сервере работа с электронным ключом в разных сессиях идет через один драйвер ключа и соответственно блокировки должны работать так же. Внимание! Пара методов GrdLock и GrdUnlock не рассчитана на вызов из разных потоков. В этом случае, при вызове GrdUnlock из другого потока ключ не будет разблокирован (здесь можно провести аналогию с работой с критическими секциями). |
|
|