General purpose fields are mainly used by the applications to locate a dongle with parameters required for its operation. This is particularly topical in cases when the developer supplies several applications protected with dongles with the same Public code, as well as in cases when each copy of the application is personalized to be used by a specific user. The information stored in the general purpose fields is used mainly for reference rather than for protecting the application.
Most of these fields are actively used for automatic protection (see Chapter 5 Automatic Protection). It is also possible to change the contents of fields and use them with Guardant API functions.
| kmNProg | Program number. This field contains the number of the protected application. Used for linking the application to the dongle in case there are several applications. Possible range of values: from 0 to 255. The field contains 0 by default. |
| kmVer | Program version. This field contains the version number of the protected application. It can be used for linking the application to the dongle in case or new releases of the application. Possible range of values: from 0 to 255. |
| kmSN | Serial number. The field contains the number of the protected application copy. Used for linking the specific copy of the application to the dongle. Possible range of values: from 0 to 65535. When writing a mask into the dongle using GrdUtil.exe utility the value of the field automatically increments on every writing session into the dongle memory. |
| kmMask | Bit mask. This field is useful if anapplication represents a complex of independent modules. Used for locking/unlocking specific modules of the software application (complex). Possible range of values: from 0 to 65535 (16 modules – 1 bit per mod-ule). |
| kmGP | Application launch counter (GP, Counter No.1). Possible range of values: from 0 to 65535. This field value will be decremented on each call of a special API function (GrdDecGP) or on each application run protected with automatic protection in a limited license term mode. |
| kmReal LANRes | Real network dongle resource of Guardant Net II (Counter No.2). This fieldcontains the real value of the network resource of the dongle. Used for licensing – limiting the number of software copies used in a LAN simultaneously. Available only for network dongles. Possible range of values: from 0 to 65535, actually is limited by kmLANRes value. |
| kmIndex | Index. This field is used for remote dongle programming utilities. Cannot be used for data storing. |