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 gmBasicwhen certain things happen or when certain points in the processing are reached.
The attributes of the LoadRuntimestatement 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 LoadRuntimestatement are as follows: