Page tree
Skip to end of metadata
Go to start of metadata

 

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

Синтаксис

     

     

    int GRD_API GrdGetInfo(	
      HANDLE hGrd,
      DWORD dwInfoCode,
      void *pInfoData,
      DWORD dwInfoSize
    );
     Параметры функции

    hGrd

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

    dwInfoCode

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

    pInfoData

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

    dwInfoSize

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

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

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

    Описание

    // Информация об API

    GrdGIV_VerAPI

    4

    Версия Guardant API. Старшее слово содержит версию API. Младшее слово содержит номер сборки API. Старший байт слова версии содержит номер старшей версии API, младший байт слова версии содержит номер младшей версии API. Пример: 0x0701005C = 7.1.92

    // Режимы работы

    GrdGIM_WorkMode

    4

    Режим работы, заданный комбинацией флагов в функции GrdSetWorkMode

    GrdGIM_HandleMode

    1

    Режим многопоточности (поле устарело, всегда возвращается значение соответствующее работе в многопоточном режиме)

    // Текущие режимы поиска и логина, установленные функцией GrdSetFindMode

    GrdGIF_Remote

    1

    Локальный и/или удаленный ключ (комбинация флагов GrdFMR_Local и GrdFMR_Remote)

    GrdGIF_Flags

    1

    Комбинация флагов поиска, установленных в параметре dwFlags функции GrdSetFindMode

    GrdGIF_Prog

    1

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

    GrdGIF_ID

    4

    Заданное в GrdSetFindMode значение для поля "Уникального идентификатора ключа"

    GrdGIF_SN

    2

    Заданное в GrdSetFindMode значение для поля "Серийного номера"

    GrdGIF_Ver

    1

    Заданное в GrdSetFindMode значение для поля "Версия"

    GrdGIF_Mask

    2

    Заданное в GrdSetFindMode значение для поля "Битовая маска"

    GrdGIF_Type

    2

    Заданное в GrdSetFindMode значение для поля "Тип ключа"

    GrdGIF_Model

    4

    Заданное в GrdSetFindMode значение для поля "Модель ключа"

    GrdGIF_Interface

    4

    Заданное в 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

    Версия драйвера 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

    32

    Локальный IP-адрес сервера Guardant Net

    GrdGIR_LocalPort

    2

    Локальный IP-порт сервера Guardant Net

    GrdGIR_LocalNB

    15

    Локальное NetBIOS-имя сервера Guardant Net

    GrdGIR_RemoteIP

    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 адрес
     Возвращаемое значение функции
     Описание

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

     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, GrdGIMGrdGIF, GrdGIL, GrdGIR

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

    infoData [out]

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

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

     Возвращаемое значение метода
     Описание

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

    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)
     Параметры метода

    grdHandle [in] 

    Тип: Handle

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

    infoCode [in]

    Тип:  GrdGIVGrdGIM, GrdGIF, GrdGILGrdGIR

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

    infoData [out]

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

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

     Возвращаемое значение метода
     Описание

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

     

     

    • No labels