- Created by Guardant Tech, last modified by Guardant R&D on Sept 02, 2014
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 5 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. |
C C# Visual Basic Visual C++
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.
Пример для используемого средства разработки см. в директории:
"\%Program Files%\Guardant\Guardant 6\%PublicCode%\Samples\x86\Win32\General Guardant API\"
или
"\%Program Files%\Guardant\Guardant 6\%Public Code%\Samples\x64\Win64\General Guardant API\"
- No labels