gmplLoadRuntimeStatement
Mark Juras
Owned by Mark Juras
LoadRuntime Statement Summary
LoadRuntime is a terminal, command statement that can occur only in command scripts. It loads a runtime Dll into the current execution space of gmBasic. This Dll may well be intermingled with Dlls loaded via the Select RuntimeDll attribute and Dlls loaded via refactoring commands. There is a maximum of 64 Dlls that may be loaded. Each DLL exports certain methods, event handlers, that are then looked for by the execution logic of gmBasic when certain things happen or when certain points in the processing are reached. The attributes of the LoadRuntime statement are as follows:| Attribute | Description |
| DllName | This attribute specifies a simple local file name of the runtime Dll to be loaded. It is looked for using the standard search order. That order is target location, local location, system location, and language location. |
| Filename | This attribute specifies the full pathname of the runtime Dll to be loaded. It is used only if the DllName attribute is omitted. |
| Event | If the DLL being loaded implements a CodeEvent event handler then this attribute specifies the identifier of this event. This event is triggered by references in the code to subcomponents that have a migUserCode value attributed to them. This is normally done with the Migrate command within a Refactor specification. Note that the event code compares only the first token of the code event string against the event identifiers of the currently active migration handlers. |
The script errors associated with the LoadRuntime statement are as follows:
| Error | Description |
| 1153 | The RuntimeDll [%1d] could not be loaded |
Table of Contents