DosQueryModuleName

Returns the fully-qualified drive, path, file name, and extension associated with the referenced module handle.

Syntax
DosQueryModuleName(hmod, cbName, pch)

Parameters

 * hmod (HMODULE) - input: The handle of the dynamic link module that is being referenced.
 * This handle is provided in the DI register on entry to a module, or on the initialization entry to a dynamic link routine.


 * cbName (ULONG) - input: The maximum length of the buffer, in bytes, where the name will be stored.
 * pch (PCHAR) - output: The address of the buffer where the file specification of the module are returned.

Return Code

 * ulrc (APIRET) - returns:DosQueryModuleName returns one of the following values:
 * 0 NO_ERROR
 * 6 ERROR_INVALID_HANDLE
 * 24 ERROR_BAD_LENGTH

Remarks
DosQueryModuleName returns the fully qualified drive, path, file name, and extension associated with the referenced module handle.

If the buffer is not large enough, an error is returned.

Example Code
This example attempts to obtain the handle of a dynamic link module named "DISPLAY.DLL," and then tests whether it is currently loaded or not. 
 * 1) define INCL_DOSMODULEMGR  /* Module Manager values */
 * 2) define INCL_DOSERRORS     /* DOS Error values */
 * 3) include 
 * 4) include 

int main(VOID) { PSZ    ModuleName    = "C:\\OS2\\DLL\\DISPLAY.DLL";  /* Module name   */ HMODULE ModuleHandle = NULLHANDLE;                   /* Module handle */ APIRET rc            = NO_ERROR;                     /* Return code   */

rc = DosQueryModuleHandle(ModuleName,     /* Module to look for       */                             &ModuleHandle);  /* Handle (returned)        */ if (rc != NO_ERROR) { printf("DosQueryModuleHandle error: return code = %u\n", rc); return 1; } else { printf ("Module handle = %u\n", ModuleHandle); }

rc = DosQueryModuleName (ModuleHandle,  /* Module handle to query     */                            256L,           /* Maximum length of result   */                            ModuleName);    /* Module name returned       */

if (rc != NO_ERROR) { printf("DosQueryModuleName error: return code = %u\n", rc); return 1; } else { printf ("Module name = %s\n", ModuleName); }  return NO_ERROR; } 

Related Functions

 * DosFreeModule
 * DosLoadModule
 * DosQueryModuleHandle