Synopsis

BPTR LDLoadSeg(
   CONST_STRPTR name)

Function

Load an executable through the loader daemon's replaceable
loading vector. The default implementation calls
dos.library/LoadSeg() with the supplied name.

Inputs

name - NUL-terminated filename. Keep the string valid until
       the call returns.

Result

A BPTR segment list, or BNULL if loading fails. On failure,
call IoErr() in the calling process for the DOS error code.

Notes

Call from a DOS process after the loader daemon has been
initialized. The default implementation runs synchronously
and may wait for file I/O. Relative names use the calling
process's current directory.

This call does not perform the loader daemon's library or
device search, initialize a resident, or start the executable.

Release the returned segment list with UnLoadSeg() when it is
no longer in use. Do not unload segments still used by code
or initialized objects.

See also

dos.library/LoadSeg() dos.library/UnLoadSeg() dos.library/IoErr()