DosLoadModule

This call loads a dynamic link module and returns a handle for the module.

DosLoadModule

(ObjNameBuf, ObjNameBufL, ModuleName, ModuleHandle)

ObjNameBuf (PSZ) - output

Address of the name of an object that contributed to the failure of DosLoadModule.
ObjNameBufL (USHORT) - input
Length, in bytes, of the buffer described by ObjNameBuf.
ModuleName (PSZ) - input
Address of the ASCIIZ name string containing the dynamic link module name or the pathname string. The filename extension used for dynamic link libraries is .DLL. When a pathname is provided, the module name may have any extension. The internal module name (the name given in the LIBRARY statement in the .DEF file) must be the same as the filename without the extension.
ModuleHandle (PHMODULE) - output
Address of the handle for the dynamic link module.
rc (USHORT) - return
Return code descriptions are:
• NO_ERROR 2
  ERROR_FILE_NOT_FOUND
  3
  ERROR_PATH_NOT_FOUND
  4
  ERROR_TOO_MANY_OPEN_FILES
  5
  ERROR_ACCESS_DENIED
  8
  ERROR_NOT_ENOUGH_MEMORY
  11
  ERROR_BAD_FORMAT
  26
  ERROR_NOT_DOS_DISK
  32
  ERROR_SHARING_VIOLATION
  33
  ERROR_LOCK_VIOLATION
  36
  ERROR_SHARING_BUFFER_EXCEEDED
  95
  ERROR_INTERRUPT
  108
  ERROR_DRIVE_LOCKED
  123
  ERROR_INVALID_NAME
  127
  ERROR_PROC_NOT_FOUND
  180
  ERROR_INVALID_SEGMENT_NUMBER
  182
  ERROR_INVALID_ORDINAL
  190
  ERROR_INVALID_MODULETYPE
  191
  ERROR_INVALID_EXE_SIGNATURE
  192
  ERROR_EXE_MARKED_INVALID
  194
  ERROR_ITERATED_DATA_EXCEEDS_64k
  195
  ERROR_INVALID_MINALLOCSIZE
  196
  ERROR_DYNLINK_FROM_INVALID_RING
  198
  ERROR_INVALID_SEGDPL
  199
  ERROR_AUTODATASEG_EXCEEDS_64k
  201
  ERROR_RELOC_CHAIN_XEEDS_SEGLIM
  206
  ERROR_FILENAME_EXCED_RANGE
  Remarks

  If the file is an OS/2 dynamic link module, it is loaded, and a handle is returned. This handle is used for freeing the dynamic link module with a DosFreeModule request, getting procedure addresses with DosGetProcAddr requests, and getting the fully qualified file name with a DosGetModName request.

  DosLoadModule may not be called from a dynamic library initialization routine if the module to be loaded or any module referenced by it contains a dynamic link library initialization routing.

  ---

  [Back: DosKillProcess]
  [Next: DosLockSeg]