Addfile() [AutoHotkey.dll or AutoHotkey_NL30N7+]

loads and compiles additional script files within AutoHotkey.dll

LinePointer := DllCall("AutoHotkey.dll\addFile", "str", filename, "uchar", [aAllowDuplicateInclude = 0], "uchar" , [aIgnoreLoadFailure = 0], "Cdecl UInt")

Parameters

LinePointer	Addfile() returns a pointer to the first line in the late included script.
filename	name of script to be compiled and added to the running script
aAllowDuplicateInclude	see Include command 0 = if a script named %filename% is already loaded, ignore 1 = load it again
aIgnoreLoadFailure	see Include command again 0 = signal an error if there was problem addfileing filename 1 = ignore error 2 = remove script lines added by previous calls to Addfile() and start executing at the first line in the new script [AutoHotkey.dll only]

Remarks

Simpleheap memory used by late included files upto this point is freed (AutoHotkey.dll only).
its addFile, not addfile. case is important for dllcall.

Examples

linePointer := DllCall("AutoHotkey.dll\addFile", "str", "addfile.ahk", "Cdecl UInt") ; adds a new include file named filename, and returns linepointer
linePointer := DllCall(A_ScriptDir . "\AutoHotkey.dll\addFile", "str", "addfile.ahk", "uchar", 0,"uchar" , 2, "Cdecl UInt"); clears all loaded functions and labels, then adds a new include file named filename, and returns linepointer