EM_twinSymFromExtMem Function (ROM Call 0x166)

vat.h

HSym EM_twinSymFromExtMem (SYM_STR SymName, HSym Sym);

Creates a twin symbol, then copies a symbol from the archive memory to it.

EM_twinSymFromExtMem first calls SymAddTwin to create a twin symbol, then copies the archived symbol to it. The symbol may be described either by symbol name SymName (in this case, parameter Sym should be set to HS_NULL) or by Hsym structure Sym (in this case, SymName must be NULL). See SYMSTR for rules about SymName. TIOS uses EM_twinSymFromExtMem when it need to execute archived program. EM_twinSymFromExtMem returns a HSym structure which represents a newly created symbol (or HS_NULL in a case of error). EM_twinSymFromExtMem returns Sym itself if the symbol is not archived.


Uses: DerefSym, HSYMtoName, SymAddTwin, SymFind, HeapAlloc, HeapFree, HeapSize, memcpy
Used by: push_user_func