Структура используемая в функции GrdApi.GrdFind для получения информации об электронном ключе
Пространство имен: Guardant
Синтаксис
#pragma pack(push,1)
typedef struct {
DWORD dwPublicCode; // Public code
BYTE byHrwVersion; // Dongle hardware version
BYTE byMaxNetRes; // Maximum Guardant Net license limit
WORD wType; // Dongle type flags
DWORD dwID; // Dongle's ID (unique) // Following fields are available from UAM mode
BYTE byNProg; // Program number
BYTE byVer; // Version
WORD wSN; // Serial number
WORD wMask; // Bit mask
WORD wGP; // Executions GP counter/ License time counter
WORD wRealNetRes; // Current Guardant Net license limit, must be <= byMaxNetRes
DWORD dwIndex; // Index for remote programming // Only Stealth III info
BYTE abyReservedISEE[0x1C]; // Reserved for future
WORD wWriteProtectS3; // Stealth III write protect address
WORD wReadProtectS3; // Stealth III read protect address
WORD wGlobalFlags; // Global dongle flags for Sign\Time or higher dongles. See GrdGF_xxx definition.
DWORD dwDongleState; // Dongle State. See GrdDSF_XXX definition // Available since: // 1. Stealth Sign.(Firmware number >= 0x01000011h or 01.00.00.11) // 2. Guardant Code.
DWORD dwOldMPNum; // Old firmware number(before SFU).
BYTE abyReservedH[0x100 - 0x1A - 0x1C - 0x0E]; // Reserved. For align to 0x100 // Reserved info from gsA // Driver info
DWORD dwGrDrv_Platform; // Driver platform (Win32/Win64) DWORD dwGrDrv_Vers; // Driver version (0x04801234=4.80.12.34
DWORD dwGrDrv_Build; // Driver build
DWORD dwGrDrv_Reserved; // dongle info
DWORD dwRkmUserAddr; // wkmUserAddr
DWORD dwRkmAlgoAddrW; // wkmAlgoAddr
DWORD dwPrnPort; // Printer port address or 0 if it USB
DWORD dwClientVersion; // Dongle client version // SAP start
DWORD dwRFlags; // Type of MCU
DWORD dwRProgVer; // Program version (in MCU)
DWORD dwRcn_rc; // curr_num & answer code
DWORD dwNcmps; // Number of compare conditions
DWORD dwNSKClientVersion; // Client version (low byte - minor, hi - major)
DWORD dwModel; // Dongle Model
DWORD dwMcuType; // Dongle MCU Type
DWORD dwMemoryType; // Dongle Memory Type // Reserved for future
BYTE abyReserved[0x200 - 0x100 - 0x28]; // Reserved. For align to 0x200
} TGrdFindInfo;
#pragma pack(pop)
Константы
TGrdFindInfo содержит следующие имена и значения.
| Имя | Тип | Описание |
|---|---|---|
| dwPublicCode | dword | Общий код доступа в числовом виде |
| byHrwVersion | byte | Аппаратная версия ключа (биты 0 -3: minor, биты 4 - 7: major) |
| byMaxNetRes | byte | Максимальный ресурс лицензий сетевого ключа (программируется компанией "Актив" при продаже ключа) |
| wType | word | Флаги типа ключа |
dwID | dword | ID ключа (программируется компанией "Актив" при продаже ключа) |
byNProg | byte | Номер программы |
byVer | byte | Версия программы |
wSN | word | Серийный номер |
| wMask | word | Битовая маска |
| wGP | word | Счетчик запусков GP (устаревшая технология, не используется) |
| wRealNetRes | word | Текущий ресурс лицензий сетевого ключа. Задается разработчиком, должен быть <= byMaxNetRes |
| dwIndex | dword | Индекс, используемый утилитами удаленного программирования |
| abyReservedISEE[28] | byte | Зарезервированная память для будущего использования |
| wWriteProtectS3 | word | SAM-адрес 1-го байта, доступного для записи. Если 0, запреты на запись отсутствуют. |
| wReadProtectS3 | word | SAM-адрес 1-го байта, доступного для чтения. Если 0, запреты на чтение отсутствуют. |
| wGlobalFlags | word | Глобальные флаги |
| dwDongleState | dword | Dongle State. See GrdDSF_XXX definition |
| dwOldMPNum | dword | Old firmware number(before SFU). |
| abyReservedH[188] | byte | Зарезервированная память для будущего использования |
| dwGrDrv_Platform | dword | Разрядность драйвера.Платформа (Win32/Win64). |
| РdwGrDrv_Vers | dword | Версия драйвера (0х05401234=5.40.12.34) |
| dwGrDrv_Build | dword | Сборка драйвера |
| dwGrDrv_Reserved | dword | Зарезервированое значение |
| dwRkmUserAddr | dword | Адрес начала пользовательской памяти в 2-хбайтовых словах |
| dwRkmAlgoAddrW | dword | Адрес таблицы размещения защищенных ячеек в словах |
| dwPrnPort | dword | Адрес LPT-порта (или 0, если ключ - USB) |
| dwClientVersion | dword | Reserved Dongle client version |
| dwRFlags | dword | Reserved Type of MCU |
| dwRProgVer | dword | Reserved Program version (in MCU) |
| dwRcn_rc | dword | Reserved curr_num & answer code |
| dwNcmps | dword | Reserved Number of compare conditions |
| dwNSKClientVersion | dword | Reserved Client version (low byte - minor, hi - major) |
| dwModel | dword | Модель ключа |
| dwMcuType | dword | Тип ключа |
| dwMemoryType | dword | Тип памяти ключа |
| abyReserved[216] | byte | Зарезервированная память для будущего использования |