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: