- Created by Guardant Tech, 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 16 Next »
Функция GrdSetFindMode устанавливает условия поиска ключей, а также режимы работы для хэндла.
int GRD_API GrdSetFindMode( HANDLE hGrd, DWORD dwRemoteMode, DWORD dwFlags, DWORD dwProg, DWORD dwID, DWORD dwSN, DWORD dwVer, DWORD dwMask, DWORD dwType, DWORD dwModels, DWORD dwInterfaces );
hGrd |
хэндл, через который будет установлен режим поиска ключей |
||||||||||||||||||||||||||||||
dwRemoteMode |
комбинация флагов GrdFMR_XXX, задающих режим поиска локальных и/или удаленных ключей
|
||||||||||||||||||||||||||||||
dwFlags |
комбинация флагов GrdFM_XXX, разрешающих учитывать при поиске параметры, записанные в обязательных полях ключа
|
||||||||||||||||||||||||||||||
dwProg |
значение, которое должно находиться в поле «Номер программы» |
||||||||||||||||||||||||||||||
dwID |
значение, которое должно находиться в поле «ID» |
||||||||||||||||||||||||||||||
dwSN |
значение, которое должно находиться в поле «Серийный номер» |
||||||||||||||||||||||||||||||
dwVer |
значение, которое должно соответствовать условиям для поля «Версия» |
||||||||||||||||||||||||||||||
dwMask |
значение, которое должно соответствовать условиям для поля «Битовая маска» |
||||||||||||||||||||||||||||||
dwType |
комбинация флагов GrdDT_XXX, задающая типы ключей, удовлетворяющие условиям поиска
|
||||||||||||||||||||||||||||||
dwModels |
комбинация флагов GrdFMM_GSX, задающая список возможных моделей ключей, участвующих в поиске
|
||||||||||||||||||||||||||||||
dwInterfaces |
комбинация флагов GrdFMI_XXX, задающая список возможных интерфейсов ключей, участвующих в поиске. Этим параметром можно, например, исключить из поиска ключи с интерфейсом LPT
|
GrdE_NeedLogout |
Попытка вызова GrdSetFindMode после GrdLogin. |
GrdE_InvalidArgs |
Значение параметра поиска отличается от значения параметра, указанного при вызове GrdStartup. |
Функция GrdSetFindMode задает условия, по которым будет осуществляться поиск электронных ключей. Можно задать условия поиска локальных или удаленных ключей нужного типа и модели, с нужным интерфейсом и набором дополнительных параметров.
Внимание!
Если в ходе текущего сеанса работы заданные параметры поиска ключа изменятся, то будет выдана ошибка GrdE_DongleNotFound, и потребуется деинициализировать Guardant API и начать новый сеанс.
Если в параметре dwFlags заданы дополнительные критерии поиска, то передаваемые через параметры функции дополнительные критерии поиска, также будут использованы при отборе ключей с подходящими под условия данными, записанными в соответствующие поля памяти. Параметры dwModels и dwInterfaces не имеют соответствующих флагов проверки и просто проверяются или нет по переданному значению режимов поиска.
При этом значения, записанные в памяти ключа будут сравниваться с параметрами функции. Для большинства из них требуется равенство, но есть и исключения. Значение, записанное в поле «Версия» ключа должно быть больше или равно значению параметра dwVer. Биты, установленные в параметре dwMask, должны быть установлены и в поле «Битовая маска» в ключе, но значения при этом могут быть не равны.
Условия поиска установленные при вызове GrdSetFindMode для конкретного хэндла сохраняются для всех попыток поиска до следующего вызова GrdSetFindMode.
GrdSetFindMode необходимо вызывать в рамках блока инициализации, до вызова GrdLogin. При попытке вызова GrdSetFindMode на залогиненном хэндле будет возвращена ошибка GrdE_NeedLogout.
public static GrdE GrdSetFindMode(Handle grdHandle,GrdFMR remoteMode, GrdFM flags, uint prog, uint id, uint sn, uint ver, uint mask,GrdDT type, GrdFMM models,GrdFMI interfaces)
grdHandle [in]
Тип: Handle
Хэндл, через который будет установлен режим поиска ключей
remoteMode [in]
Тип: GrdFMR
Комбинация флагов в GrdFMR, которые задают режим поиска локальных и/или удаленных ключей.
flags [in]
Тип: GrdFM
комбинация флагов в GrdFM, которые дают возможность учитывать при поиске параметры, записанные в обязательных полях ключа.
prog [in]
Тип: uint
Значение, которое должно находиться в поле «Номер программы»
id [in]
Тип: uint
Значение, которое должно находиться в поле «ID»
sn [in]
Тип: uint
Значение, которое должно находиться в поле «Серийный номер»
ver [in]
Тип: uint
Значение, которое должно соответствовать условиям для поля «Версия»
mask [in]
Тип: uint
Значение, которое должно соответствовать условиям для поля «Битовая маска»
type [in]
Тип: GrdDT
Комбинация флагов в GrdDT, которая задает типы ключей, удовлетворяющие условиям поиска.
models [in]
Тип: GrdFMM
Комбинация флагов в GrdFMM, которая задает список возможных моделей ключей, участвующих в поиске.
interfaces [in]
Тип: GrdFMI
Комбинация флагов в GrdFMI, которые задают список возможных интерфейсов ключей, участвующих в поиске.
Функция GrdSetFindMode задает условия, по которым будет осуществляться поиск электронных ключей. Можно задать условия поиска локальных или удаленных ключей нужного типа и модели, с нужным интерфейсом и набором дополнительных параметров.
Внимание!
Если в ходе текущего сеанса работы заданные параметры поиска ключа изменятся, то будет выдана ошибка GrdE_DongleNotFound, и потребуется деинициализировать Guardant API и начать новый сеанс.
Если в параметре dwFlags заданы дополнительные критерии поиска, то передаваемые через параметры функции дополнительные критерии поиска, также будут использованы при отборе ключей с подходящими под условия данными, записанными в соответствующие поля памяти. Параметры dwModels и dwInterfaces не имеют соответствующих флагов проверки и просто проверяются или нет по переданному значению режимов поиска.
При этом значения, записанные в памяти ключа будут сравниваться с параметрами функции. Для большинства из них требуется равенство, но есть и исключения. Значение, записанное в поле «Версия» ключа должно быть больше или равно значению параметра dwVer. Биты, установленные в параметре dwMask, должны быть установлены и в поле «Битовая маска» в ключе, но значения при этом могут быть не равны.
Условия поиска установленные при вызове GrdSetFindMode для конкретного хэндла сохраняются для всех попыток поиска до следующего вызова GrdSetFindMode.
GrdSetFindMode необходимо вызывать в рамках блока инициализации, до вызова GrdLogin. При попытке вызова GrdSetFindMode на залогиненном хэндле будет возвращена ошибка GrdE_NeedLogout.
public static GrdE GrdSetFindMode(Handle grdHandle, GrdFMR remoteMode, GrdFM flags, byte prog, int id, short sn, byte ver, short mask, GrdDT type, GrdFMM models, GrdFMI interfaces)
grdHandle [in]
Тип: Handle
Хэндл, через который будет установлен режим поиска ключей
remoteMode [in]
Тип: GrdFMR
Комбинация флагов в GrdFMR, которые задают режим поиска локальных и/или удаленных ключей.
flags [in]
Тип: GrdFM
комбинация флагов в GrdFM, которые дают возможность учитывать при поиске параметры, записанные в обязательных полях ключа.
prog [in]
Тип: byte
Значение, которое должно находиться в поле «Номер программы»
id [in]
Тип: int
Значение, которое должно находиться в поле «ID»
sn [in]
Тип: short
Значение, которое должно находиться в поле «Серийный номер»
ver [in]
Тип: byte
Значение, которое должно соответствовать условиям для поля «Версия»
mask [in]
Тип: short
Значение, которое должно соответствовать условиям для поля «Битовая маска»
type [in]
Тип: GrdDT
Комбинация флагов в GrdDT, которая задает типы ключей, удовлетворяющие условиям поиска.
models [in]
Тип: GrdFMM
Комбинация флагов в GrdFMM, которая задает список возможных моделей ключей, участвующих в поиске.
interfaces [in]
Тип: GrdFMI
Комбинация флагов в GrdFMI, которые задают список возможных интерфейсов ключей, участвующих в поиске.
Функция GrdSetFindMode задает условия, по которым будет осуществляться поиск электронных ключей. Можно задать условия поиска локальных или удаленных ключей нужного типа и модели, с нужным интерфейсом и набором дополнительных параметров.
Внимание!
Если в ходе текущего сеанса работы заданные параметры поиска ключа изменятся, то будет выдана ошибка GrdE_DongleNotFound, и потребуется деинициализировать Guardant API и начать новый сеанс.
Если в параметре dwFlags заданы дополнительные критерии поиска, то передаваемые через параметры функции дополнительные критерии поиска, также будут использованы при отборе ключей с подходящими под условия данными, записанными в соответствующие поля памяти. Параметры dwModels и dwInterfaces не имеют соответствующих флагов проверки и просто проверяются или нет по переданному значению режимов поиска.
При этом значения, записанные в памяти ключа будут сравниваться с параметрами функции. Для большинства из них требуется равенство, но есть и исключения. Значение, записанное в поле «Версия» ключа должно быть больше или равно значению параметра dwVer. Биты, установленные в параметре dwMask, должны быть установлены и в поле «Битовая маска» в ключе, но значения при этом могут быть не равны.
Условия поиска установленные при вызове GrdSetFindMode для конкретного хэндла сохраняются для всех попыток поиска до следующего вызова GrdSetFindMode.
GrdSetFindMode необходимо вызывать в рамках блока инициализации, до вызова GrdLogin. При попытке вызова GrdSetFindMode на залогиненном хэндле будет возвращена ошибка GrdE_NeedLogout.
- No labels