DosGetModHandle

Bindings:  C, MASM 

This call returns a handle to a previously loaded dynamic link module. 

 DosGetModHandle     (ModuleName, ModuleHandle) 
 

 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 when a module name is provided is .DLL.  When a 
    pathname is provided, the module name may have any extension. 

 ModuleHandle (PHMODULE) - output 
    Address of the handle for the dynamic link module. 

 rc (USHORT) - return 
    Return code descriptions are: 

    0         NO_ERROR 
    95        ERROR_INTERRUPT 
    123       ERROR_INVALID_NAME 
    126       ERROR_MOD_NOT_FOUND 
 
 Remarks 

 If a module name is provided, it must match the name of a module residing 
 in the LIBPATH that is currently loaded.  Otherwise an error code is 
 returned.  If a pathname is provided, the expanded pathname must match 
 the full pathname of a module that is currently loaded. 

 The handle returned by this call can be used with DosGetModName.  It 
 should not be used with DosGetProcAddr for access to the already loaded 
 dynamic link module.  Instead, DosLoadModule should be issued to ensure 
 that the calling process is attached to the module.