card default true Card |
---|
| Code Block |
---|
| int GRD_API GrdGetInfo(
HANDLE hGrd,
DWORD dwInfoCode,
DWORDvoid *pInfoData,
DWORD dwInfoSize
); |
Expand |
---|
| hGrd | хэндл, из которого нужно получить информацию | dwInfoCode | код запрашиваемой информации, см. константы GrdGIX_XXXXX | pInfoData | указатель на буфер, в который будет помещена запрашиваемая информация | dwInfoSize | размер длина возвращаемого буфера |
Код запрашиваемой информации | Возвращаемый размер | Длина возвращаемого буфера | ОписаниеКомментарий |
---|
// Информация об API |
---|
GrdGIV_VerAPI | 4 | Версия API (0x05401234=5.40.12.34)Guardant API. Старшее слово содержит версию API. Младшее слово содержит номер сборки API. Старший байт слова версии содержит номер старшей версии API, младший байт слова версии содержит номер младшей версии API. Пример: 0x0701005C = 7.1.92 | // Режимы работы// Common Mode |
---|
GrdGIM_WorkMode | 4 | Режим работы, заданный комбинацией флагов GrdWM_XXXX в флагов в функции GrdSetWorkMode | GrdGIM_HandleMode | 1 | Режим хэндла (монопольный/многопоточныймногопоточности (поле устарело, всегда возвращается значение соответствующее работе в многопоточном режиме) | // Текущие режимы поиска и логина, установленные функцией GrdSetFindMode |
---|
GrdGIF_Remote | 1 | Локальный и/или удаленный ключ (комбинация флагов GrdFMR_Local и GrdFMR_Remote) | GrdGIF_Flags | 1 | Комбинация флагов поискаGrdFM_XXXX, установленных в параметре dwFlags функции GrdSetFindMode | GrdGIF_Prog | 1Номер | программыЗаданное в GrdSetFindMode значение для поля "Номера программы" | GrdGIF_ID | 4ID | ключаЗаданное в GrdSetFindMode значение для поля "Уникального идентификатора ключа" | GrdGIF_SN | 2Серийный номер | Заданное в GrdSetFindMode значение для поля "Серийного номера" | GrdGIF_Ver | 1 | Заданное в GrdSetFindMode значение для поля "Версия" | GrdGIF_Mask | 2 | Заданное в GrdSetFindMode значение для поля "Битовая маска" | GrdGIF_Type | 2 | Заданное в GrdSetFindMode значение для поля "Тип ключа" | GrdGIF_Model | 4Биты возможных моделей ключа. Список моделей кодируется битами, установленными в разрядах с номерами, соответствующими значениям констант GrdDM_XXX 1 << GrdDM_XXX (GS1L, GS1U, GF1L, GS2L, GS2U ) | Заданное в GrdSetFindMode значение для поля "Модель ключа" | GrdGIF_Interface | 4 | Биты возможных интерфейсов. Список интерфейсов кодируется битами, установленными в разрядах с номерами, соответствующими значениям констант GrdDI_XXX 1 << GrdDI_XXX (LPT|USB) | Заданное в GrdSetFindMode значение для поля "Интерфейс" | // Информация // Регистрационная информация о текущем ключe, устанавливаемая функцией GrdLogin |
---|
GrdGIL_Remote | 1 | Удаленный или локальный ключ. Если 0, то это локальный ключ, если 1, то удаленный | GrdGIL_ID | 4 | ID текущего ключа | GrdGIL_Model | 1 | Модель текущего ключа | GrdGIL_Interface | 1 | Интерфейс текущего ключа | GrdGIL_LockCounter | 4 | Счетчик блокировок текущего ключа | GrdGIL_Seek | 4 | Текущее значение указателя памяти ключа в текущей системе адресации | // Регистрационная информация Информация о текущем удаленном или локальном драйвере ключа |
---|
GrdGIL_DrvVers | 2 | Версия драйвера (0x0551=5.51)Guardant. Старший байт слова содержит номер старшей версии драйвера, младший байт слова содержит номер младшей версии драйвера. Пример: 0x0701 = 7.1 | GrdGIL_DrvBuild | 1 | Номер билда сборки драйвера | GrdGIL_PortLPT | 2 | Адрес LPT порта, к которому подключен текущий ключ (0 == USBдля USB) | GrdGIL_SoftFileName | | Полный путь к активированному контейнеру Guardant SP (строка в формате Unicode) | // Регистрационная информация Информация о текущем удаленном ключе |
---|
GrdGIR_VerSrv | 8 | Версия и номер билда сервера Guardant Net | GrdGIR_LocalIP | 1532 | Локальный IP-адрес сервера Guardant Net | GrdGIR_LocalPort | 2 | Локальный IP-порт сервера Guardant Net | GrdGIR_LocalNB | 15 | Локальное NetBIOS-имя сервера Guardant Net | GrdGIR_RemoteIP | 1532 | Удаленный IP-адрес сервера Guardant Net | GrdGIR_RemotePort | 2 | Удаленный IP-порт сервера Guardant Net | GrdGIR_RemoteNB | 15 | Удаленное NetBIOS-имя сервера Guardant Net | GrdGIR_IniTimeOutSend | 4 | Таймаут на отправку пакетов (из файла настроек сетевого клиента) | GrdGIR_IniTimeOutReceive | 4 | Таймаут на приём пакетов (из файла настроек сетевого клиента) | GrdGIR_IniTimeOutSearch | 4 | Таймаут на широковещательный поиск (из файла настроек сетевого клиента) | GrdGIR_IniClientUDPPort | 2 | UDP-порт клиента (поле устарело, всегда возвращается основной порт подключения к серверу) | GrdGIR_IniServerUDPPort | 2 | UDP-порт сервера (поле устарело, всегда возвращается основной порт подключения к серверу) | GrdGIR_IniBroadcastAddress | 32 | Широковещательный адрес сервера (из файла настроек сетевого клиента) | GrdGIR_IniFileName | | Полный путь к файлу сетевых настроек клиента | GrdGIR_LocalMACAddress | 21 | MAC адрес сетевого адаптера | GrdGIR_FullHostName | 255 | Полное имя локального компьютера | GrdGIR_IniServerIPName | 255 | Имя сервера или его IP адрес |
|
Expand |
---|
title | Возвращаемое значение функции |
---|
| Функция GrdGetInfo записывает по адресу, указанному в параметре pInfoData значение, содержащее запрошенную информацию из хэндла. Размер передаваемого буфера указывается параметром dwInfoSize.Набор ошибок Guardant API |
Expand |
---|
| Функция GrdGetInfo используется для получения различных данных о ключах и режимах из защищенного хранилища, на которое указывает хэндл hGrd. . Функция GrdGetInfo записывает по адресу, указанному в параметре pInfoData значение, содержащее запрошенную информацию из хэндла. Размер передаваемого буфера указывается параметром dwInfoSize. Вызов с параметрами GrdGIL_DrvVers, GrdGIL_DrvBuild приводит к возврату значений в формате, полностью аналогичном формату GrdDrvGetVersion. Вызов с параметром GrdGIV_VerAPI приводит к возврату 0x05400000, что соответствует верcии API 5.40 (т. е. кодируется в старшем слове, в шестнадцатеричном формате). |
| Card |
---|
| Card |
---|
| Code Block |
---|
| public static GrdE GrdGetInfo(Handle grdHandle, GrdInfo infoCode, out byte infoData)
public static GrdE GrdGetInfo(Handle grdHandle, GrdInfo infoCode, out ushort infoData)
public static GrdE GrdGetInfo(Handle grdHandle, GrdInfo infoCode, out uint infoData)
public static GrdE GrdGetInfo(Handle grdHandle, GrdInfo infoCode, out ulong infoData)
public static GrdE GrdGetInfo(Handle grdHandle, GrdInfo infoCode, byte[] infoData)
public static GrdE GrdGetInfo(Handle grdHandle, GrdGIR infoCode, out byte[] infoData) |
Expand |
---|
| grdHandle [in] Тип: Handle хэндл, из которого нужно получить информацию infoCode [in] Тип: GrdInfo код запрашиваемой информации infoCode [in] Тип: GrdGIV, GrdGIM, GrdGIF, GrdGIL, GrdGIR код запрашиваемой информации infoData [out] Тип: byte, ushort, uint, ulong, byte[ ] запрашиваемая информация |
Expand |
---|
| Метод GrdGetInfo используется для получения различных данных о ключах и режимах из защищенного хранилища, на которое указывает хэндл grdHandle. Вызов с параметрами DrvVers и DrvBuild класса GrdGIL приводит к возврату значений в формате, полностью аналогичном формату GrdDrvGetVersion. Вызов с параметром VerAPI класса GrdGIV приводит к возврату 0x05400000, что соответствует верcии API 5.40 (т. е. кодируется в старшем слове, в шестнадцатеричном формате). |
|
Card |
---|
| Code Block |
---|
| public static GrdE GrdGetInfo(Handle grdHandle, GrdInfo infoCode, byte[] infoData)
public static GrdE GrdGetInfo(Handle grdHandle, GrdInfo infoCode, short[] infoData)
public static GrdE GrdGetInfo(Handle grdHandle, GrdInfo infoCode, int[] infoData)
public static GrdE GrdGetInfo(Handle grdHandle, GrdInfo infoCode, long[] infoData) |
Expand |
---|
| grdHandle [in] Тип: Handle хэндл, из которого нужно получить информацию infoCode [in] Тип: GrdInfo код запрашиваемой информации infoCode [in] Тип: GrdGIV, GrdGIM, GrdGIF, GrdGIL, GrdGIR код запрашиваемой информации infoData [out] Тип: short [ ], int [ ], long [ ], byte[ ] запрашиваемая информация |
Expand |
---|
| Метод GrdGetInfo используется для получения различных данных о ключах и режимах из защищенного хранилища, на которое указывает хэндл grdHandle. Вызов с параметрами DrvVers и DrvBuild класса GrdGIL приводит к возврату значений в формате, полностью аналогичном форматуGrdDrvGetVersion. Вызов с параметром VerAPI класса GrdGIV приводит к возврату 0x05400000, что соответствует верcии API 5.40 (т. е. кодируется в старшем слове, в шестнадцатеричном формате). |
|
|