DosGetModName

From EDM2
Jump to: navigation, search

This call returns the fully qualified drive, path, file name, and extension associated with a referenced module handle.

Syntax

DosGetModName (ModuleHandle, BufferLength, Buffer)

Parameters

ModuleHandle (HMODULE) - input 
Handle of the dynamic link module being referenced.
BufferLength (USHORT) - input 
Maximum length of the buffer, in bytes, where the name is stored.
Buffer (PCHAR) - output 
Address of the buffer where the fully qualified drive, path, filename, and extension of the dynamic link module are stored.

Return Code

rc (USHORT) - return
Return code descriptions are:
  • 0 NO_ERROR
  • 6 ERROR_INVALID_HANDLE
  • 24 ERROR_BAD_LENGTH
  • 95 ERROR_INTERRUPT

Remarks

The handle returned by either a DosGetModHandle or a DosLoadModule request can be used with this call. An error is returned if the buffer is not large enough for the module name.

Bindings

C

#define INCL_DOSMODULEMGR

USHORT  rc = DosGetModName(ModuleHandle, BufferLength, Buffer);

HMODULE ModuleHandle;  /* Module handle */
USHORT  BufferLength;  /* Buffer length */
PCHAR   Buffer;        /* Buffer (returned) */

USHORT  rc;            /* return code */

MASM

EXTRN  DosGetModName:FAR
INCL_DOSMODULEMGR   EQU 1

PUSH   WORD    ModuleHandle  ;Module handle
PUSH   WORD    BufferLength  ;Buffer length
PUSH@  OTHER   Buffer        ;Buffer (returned)
CALL   DosGetModName

Returns WORD