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

Синтаксис

int GRD_API GrdGetInfo(	
  HANDLE hGrd,
  DWORD dwInfoCode,
  DWORD *pInfoData,
  DWORD dwInfoSize
);

hGrd	хэндл, из которого нужно получить информацию
dwInfoCode	код запрашиваемой информации
pInfoData	указатель на буфер, в который будет помещена запрашиваемая информация
dwInfoSize	длина возвращаемого буфера

Код запрашиваемой информации	Длина возвращаемого буфера	Описание
// Информация об API
GrdGIV_VerAPI	4	Версия API (0x05401234=5.40.12.34)
// Режимы работы
GrdGIM_WorkMode	4	Режим работы, заданный комбинацией флагов GrdWM_XXXX в функции GrdSetWorkMode
GrdGIM_HandleMode	1	Режим хэндла (монопольный/многопоточный)
// Текущие режимы поиска и логина, установленные функцией GrdSetFindMode
GrdGIF_Remote	1	Локальный и/или удаленный ключ (комбинация флагов GrdFMR_Local и GrdFMR_Remote)
GrdGIF_Flags	1	Комбинация флагов поиска, установленных в параметре dwFlags функции GrdSetFindMode
GrdGIF_Prog	1	Номер программы
GrdGIF_ID	4	ID ключа
GrdGIF_SN	2	Серийный номер
GrdGIF_Ver	1	Версия
GrdGIF_Mask	2	Битовая маска
GrdGIF_Type	2	Тип ключа
GrdGIF_Model	4	Биты возможных моделей ключа. Список моделей кодируется битами, установленными в разрядах с номерами, соответствующими значениям констант GrdDM_XXX 1 << GrdDM_XXX (GS1L, GS1U, GF1L, GS2L, GS2U )
GrdGIF_Interface	4	Биты возможных интерфейсов. Список интерфейсов кодируется битами, установленными в разрядах с номерами, соответствующими значениям констант GrdDI_XXX 1 << GrdDI_XXX (LPT\|USB)
// Регистрационная информация о текущем ключe, устанавливаемая функцией GrdLogin
GrdGIL_Remote	1	Удаленный или локальный ключ. Если 0, то это локальный ключ, если 1, то удаленный
GrdGIL_ID	4	ID текущего ключа
GrdGIL_Model	1	Модель текущего ключа
GrdGIL_Interface	1	Интерфейс текущего ключа
GrdGIL_LockCounter		Счетчик блокировок текущего ключа
GrdGIL_Seek	4	Текущее значение указателя памяти ключа в текущей системе адресации
// Регистрационная информация о текущем удаленном или локальном драйвере ключа
GrdGIL_DrvVers	2	Версия драйвера (0x0551=5.51)
GrdGIL_DrvBuild	1	Номер билда драйвера
GrdGIL_PortLPT	2	Адрес LPT порта, к которому подключен текущий ключ (0 == USB)
GrdGIL_SoftFileName		Software dongle container file name unicode string
// Регистрационная информация о текущем удаленном ключе
GrdGIR_VerSrv	8	Версия и номер билда сервера Guardant Net
GrdGIR_LocalIP	15	Локальный IP-адрес сервера Guardant Net
GrdGIR_LocalPort	2	Локальный IP-порт сервера Guardant Net
GrdGIR_LocalNB	15	Локальное NetBIOS-имя сервера Guardant Net
GrdGIR_RemoteIP	15	Удаленный IP-адрес сервера Guardant Net
GrdGIR_RemotePort	2	Удаленный IP-порт сервера Guardant Net
GrdGIR_RemoteNB	15	Удаленное NetBIOS-имя сервера Guardant Net
GrdGIR_HeartBeatThread		Handle of internal heartbeat thread
GrdGIR_IniTimeOutSend		Send operation timeout in seconds. Requires the API to be started up with GrdFMR_Remote flag.
GrdGIR_IniTimeOutReceive		Receive operation timeout in seconds. Requires the API to be started up with GrdFMR_Remote flag.
GrdGIR_IniTimeOutSearch		Broadcasting search timeout in seconds. Requires the API to be started up with GrdFMR_Remote flag.
GrdGIR_IniClientUDPPort		Client's UDP port for sending of datagrams to a server. Requires the API to be started up with GrdFMR_Remote flag.
GrdGIR_IniServerUDPPort		Server's UDP port for sending of replies to a client. Requires the API to be started up with GrdFMR_Remote flag.
GrdGIR_IniBroadcastAddress		Broadcasting address . Requires the API to be started up with GrdFMR_Remote flag.
GrdGIR_IniFileName		Initialization file name. Requires the API to be started up with GrdFMR_Remote flag.
GrdGIR_LocalMACAddress		MAC address of the local network adapter. Requires the API to be started up with GrdFMR_Remote flag.
GrdGIR_FullHostName		Full name of the local host. Requires the API to be started up with GrdFMR_Remote flag.
GrdGIR_IniServerIPName		Server IP address or host name. Requires the API to be started up with GrdFMR_Remote flag.

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

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

 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)

grdHandle [in]

Тип: Handle

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

infoCode [in]

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

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

infoData [out]

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

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

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

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

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)