All methods in the GX API require the user to have been granted the right to access that method in the way it is being used by your program. The entitlements of the end-user are checked when a GX (or external program) calls a GX API function. Each function will fall under one of the license classes below:
Type | Description |
|---|---|
Open | No entitlements are needed to access these classes and methods, and this includes all methods and functions that support data import and export. Note, that some Open methods may have reduced functionality. User systems that use. |
Licensed | These methods require the end-user to be licensed or subscribed to a basic Geosoft desktop environment. |
Extended | These methods require specific Geosoft extensions. We recommended that GX Developers should not use Extended methods. |
A user that runs a GX or program that includes calls to method calls for which she is not entitled will receive an error like:
| Code Block |
|---|
geosoft.GX.Error: Unable to bind the "rGet_PG(h_gxx)" wrapper function. The DLL may not be present or a license may be missing. |
Well written programs or GXs should catch this error and report the problem to the user with a recommended course of action.
Malicious Code Protection
To protect against malicious code and viruses, Geosoft has instituted a Signed GX system. All GX’s compiled by Geosoft are signed and will only execute if they have been licensed for execution on your system. If a signed compiled GX is modified in any way it will not be considered safe and will not execute.
All GX's you compile, or which are compiled and supplied by a third party are considered un-signed. Users can still execute unsigned GX’s but a warning will appear indicating that this GX was not signed and will ask the user to:
Run Once (Run the GX but only this time)
...