Composition Setup

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

Синтаксис

Входные параметры

Deck of Cards

id	001

Wiki Markup

{dojo-tabs:theme=tundra|id=1} {dojo-tab:title=C|selected=true} *C*

Card

label	C

Code Block

language	cpp

int GRD_API GrdGetInfo(	
  HANDLE hGrd,
  DWORD dwInfoCode,

DWORD

void *pInfoData,
  DWORD dwInfoSize
);

{dojo-tab} {dojo-tab:title=C#|selected=true} *C#* {dojo-tab} {dojo-tab:title=Visual Basic (Declaration)} *Visual Basic* {dojo-tab} {dojo-tab:title=Visual C++} *Visual C++* {dojo-tab} {dojo-tabs}

Expand

title

Параметры функции

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

, см. константы GrdGIX_XXXXX


pInfoData	указатель на буфер, в который будет помещена запрашиваемая информация
dwInfoSize

размер

длина возвращаемого буфера

dwInfoCode

dwInfoSize

Комментарий

Код запрашиваемой информации	Длина возвращаемого буфера	Описание
// Информация об API
GrdGIV_VerAPI	4	Версия

API (0x05401234=5.40.12.34)// Common Mode

// Режимы работы
Guardant API. Старшее слово содержит версию API. Младшее слово содержит номер сборки API. Старший байт слова версии содержит номер старшей версии API, младший байт слова версии содержит номер младшей версии API. Пример: 0x0701005C = 7.1.92
GrdGIM_WorkMode	4	Режим работы, заданный комбинацией

флагов GrdWM_XXXX в

флагов в функции GrdSetWorkMode
GrdGIM_HandleMode	1	Режим

хэндла (монопольный/многопоточный

// Текущие режимы поиска и логина, установленные функцией GrdSetFindMode
многопоточности (поле устарело, всегда возвращается значение соответствующее работе в многопоточном режиме)
GrdGIF_Remote	1	Локальный и/или удаленный ключ

, комбинация флагов GrdFMR_ХХХХ (

(комбинация флагов GrdFMR_Local

+

и GrdFMR_Remote)
GrdGIF_Flags	1	Комбинация флагов поиска

GrdFM_XXXX

, установленных в параметре dwFlags функции GrdSetFindMode
GrdGIF_Prog	1

Номер программы

Заданное в GrdSetFindMode значение для поля "Номера программы"
GrdGIF_ID	4

ID ключа

Заданное в 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)
GrdGIL_SoftFileName		Полный путь к активированному контейнеру Guardant SP (строка в формате Unicode)

Регистрационная информация

Информация о текущем удаленном ключе
GrdGIR_VerSrv	8	Версия и номер билда сервера Guardant Net
GrdGIR_LocalIP

15

32	Локальный IP-адрес сервера Guardant Net
GrdGIR_LocalPort	2	Локальный IP-порт сервера Guardant Net
GrdGIR_LocalNB	15	Локальное NetBIOS-имя сервера Guardant Net
GrdGIR_RemoteIP

15

32	Удаленный 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	Возвращаемое значение функции

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

Expand

title

Выходные параметры

Описание

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

Функция

Card

default	true
label	C#
title	C#

Code Block

language	c#

 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]

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

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

infoData [out]

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

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

Expand

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

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

Expand

title	Описание

Метод

GrdGetInfo используется для получения различных данных о ключах и режимах из защищенного хранилища, на которое указывает хэндл

hGrd

grdHandle.
Вызов с параметрами

GrdGIL_

DrvVers

,

и DrvBuild класса GrdGIL

_DrvBuild

приводит к возврату значений в формате, полностью аналогичном формату GrdDrvGetVersion.

Вызов с параметром GrdGIV_VerAPI приводит к возврату 0x05400000, что соответствует верcии API 5.40 (т. е. кодируется в старшем слове, в шестнадцатеричном формате). Expand

title	Пример

Пример для используемого средства разработки см. в директории:

"\%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\"

Card

label	Java

Code Block

language	java

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]

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

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

infoData [out]

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

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

Expand

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

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

Expand

title	Описание

Метод GrdGetInfo используется для получения различных данных о ключах и режимах из защищенного хранилища, на которое указывает хэндл grdHandle.
Вызов с параметрами DrvVers и DrvBuild класса GrdGIL приводит к возврату значений в формате, полностью аналогичном формату GrdDrvGetVersion.

Page tree

Versions Compared

Old Version 1

New Version Current

Key

Синтаксис

Page tree

Page History

Versions Compared

Old Version 1

New Version Current

Key

Синтаксис