GetModuleFileName
The GetModuleFileName
function retrieves the full path and filename for the executable file
containing the specified module.
Windows
95: The GetModuleFilename
function will return long filenames when an application s version number is
greater than or equal to 4.00 and the long filename is available. Otherwise, it
returns only 8.3 format filenames.
DWORD GetModuleFileName(
|
HMODULE hModule, |
// handle to module
to find filename for |
|
LPTSTR lpFilename, |
// pointer to
buffer for module path |
|
DWORD nSize |
// size of buffer,
in characters |
|
); |
|
Parameters
hModule
Identifies
the module whose executable filename is being requested. If this parameter is
NULL, GetModuleFileName returns the path for the file used to create the
calling process.
lpFilename
Points to a
buffer that is filled in with the path and filename of the given module.
nSize
Specifies the
length, in characters, of the lpFilename buffer. If the length of the
path and filename exceeds this limit, the string is truncated.
Return Values
If the
function succeeds, the return value is the length, in characters, of the string
copied to the buffer.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
If a module
is loaded in two processes, its module filename in one process may differ in
case from its module filename in the other process.
See Also