Versions Compared

Old Version 27

changes.mady.by.user Guardant

Saved on

compared with

New Version Current

changes.mady.by.user Guardant Support

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Composition Setup
 

 

Функция(метод) GrdGetInfo получает информацию из защищенного контейнера по указанному коду.

Синтаксис

Deck of Cards
id001
card

 

default

 

true
Card
labelC
Code Block
languagecpp
int GRD_API GrdGetInfo(	
  HANDLE hGrd,
  DWORD dwInfoCode,
  DWORDvoid *pInfoData,
  DWORD dwInfoSize
);
Expand
titleПараметры функции

hGrd

хэндл, из которого нужно получить информацию

dwInfoCode

код запрашиваемой информации

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_IniTimeOutReceive4Таймаут на приём пакетов (из файла настроек сетевого клиента)
GrdGIR_IniTimeOutSearch4Таймаут на широковещательный поиск (из файла настроек сетевого клиента)
GrdGIR_IniClientUDPPort2UDP-порт клиента (поле устарело, всегда возвращается основной порт подключения к серверу)

GrdGIR_IniServerUDPPort 

2UDP-порт сервера (поле устарело, всегда возвращается основной порт подключения к серверу)
GrdGIR_IniBroadcastAddress32 Широковещательный адрес сервера (из файла настроек сетевого клиента)

GrdGIR_IniFileName

 Полный путь к файлу сетевых настроек клиента

GrdGIR_LocalMACAddress

21MAC адрес сетевого адаптера

GrdGIR_FullHostName

255Полное имя локального компьютера
GrdGIR_IniServerIPName255Имя сервера или его IP адрес
Expand
titleВозвращаемое значение функции

Функция GrdGetInfo записывает по адресу, указанному в параметре pInfoData значение, содержащее запрошенную информацию из хэндла. Размер передаваемого буфера указывается параметром dwInfoSize.Набор ошибок Guardant API

Expand
titleОписание

Функция GrdGetInfo используется для получения различных данных о ключах и режимах из защищенного хранилища, на которое указывает хэндл hGrd.
. Функция GrdGetInfo записывает по адресу, указанному в параметре pInfoData значение, содержащее запрошенную информацию из хэндла. Размер передаваемого буфера указывается параметром dwInfoSize. Вызов с параметрами GrdGIL_DrvVers, GrdGIL_DrvBuild приводит к возврату значений в формате, полностью аналогичном формату GrdDrvGetVersion. 
Вызов с параметром GrdGIV_VerAPI приводит к возврату 0x05400000, что соответствует верcии API 5.40 (т. е. кодируется в старшем слове, в шестнадцатеричном формате).

card
Card
defaulttrue
labelC#
titleC#
Code Block
languagec#
 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
titleПараметры метода

grdHandle [in] 

Тип: Handle

хэндл, из которого нужно получить информацию

infoCode [in]

Тип: GrdInfo

код запрашиваемой информации

infoCode [in]

Тип:  GrdGIV, GrdGIM, GrdGIF, GrdGIL, GrdGIR

код запрашиваемой информации

infoData [out]

Тип:  byte, ushort, uint, ulong, byte[ ]

запрашиваемая информация

Expand
titleВозвращаемое значение метода

Набор ошибок Guardant API

Expand
titleОписание

Метод  GrdGetInfo используется для получения различных данных о ключах и режимах из защищенного хранилища, на которое указывает хэндл grdHandle.
Вызов с параметрами DrvVers и DrvBuild класса GrdGIL приводит к возврату значений в формате, полностью аналогичном формату GrdDrvGetVersion.  Вызов с параметром VerAPI класса GrdGIV приводит к возврату 0x05400000, что соответствует верcии API 5.40 (т. е. кодируется в старшем слове, в шестнадцатеричном формате).

Card
labelJava
Code Block
languagejava
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
titleПараметры метода

grdHandle [in] 

Тип: Handle

хэндл, из которого нужно получить информацию

infoCode [in]

Тип: GrdInfo

код запрашиваемой информации

infoCode [in]

Тип: GrdGIV, GrdGIM, GrdGIF, GrdGIL, GrdGIR

код запрашиваемой информации

infoData [out]

Тип:  short [ ], int [ ], long [ ], byte[ ]

запрашиваемая информация

Expand
titleВозвращаемое значение метода

Набор ошибок Guardant API

Expand
titleОписание

Метод  GrdGetInfo используется для получения различных данных о ключах и режимах из защищенного хранилища, на которое указывает хэндл grdHandle.
Вызов с параметрами DrvVers и DrvBuild класса GrdGIL приводит к возврату значений в формате, полностью аналогичном форматуGrdDrvGetVersion. 
Вызов с параметром VerAPI класса GrdGIV приводит к возврату 0x05400000, что соответствует верcии API 5.40 (т. е. кодируется в старшем слове, в шестнадцатеричном формате).