Функция GetModuleFileNameEx

Функция GetModuleFileNameEx извлекает полный путь доступа к файлу, имеющем в своем составе указанный модуль.

Синтаксис

DWORD GetModuleFileNameEx(
  HANDLE hProcess,
  HMODULE hModule,
  LPTSTR lpFilename,
  DWORD nSize
);

Параметры

hProcess

[in] Дескриптор процесса, который содержит модуль.

Дескриптор должен иметь права доступа к файлу PROCESS_QUERY_INFORMATION и PROCESS_VM_READ. Дополнительную информацию смотри в статье Защита процесса и права доступа.

hModule

[in] Дескриптор модуля. Если этот параметр - ПУСТО (NULL), то функция GetModuleFileNameEx возвращает путь исполняемого файла процесса, заданного в параметре hProcess.

lpFilename

[out] Указатель на буфер с нулевым символом в конце, который получает полный путь доступа к модулю. Если размер имени файла является большим чем значение  параметра nSize, имя файла обрезается и завершается нулем.

nSize

[in] Размер буфера, определяемого параметром lpFilename.

Возвращаемые значения

Если функция завершается успешно, возвращаемое значение задает длину строки, скопированную в буфер.

Если функция завершается ошибкой, возвращаемое значение - нуль. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Пример смотри в статье Перечисление всех модулей в процессе.

Смотри также

Обзор Помощник в обработке состояния, Функции, используемые PSAPI, Функции, используемые DLLEnumProcesses, GetModuleBaseName, GetModuleFileName, GetModuleHandle, LoadLibrary

Размещение и совместимость GetModuleFileNameEx

К Windows XP Да 
л Windows 2000 Professional Да
и Windows NT  Workstation Да версии 4.0 и выше
е Windows Me Да
н Windows 98 Да
т Windows 95 Да
 
С Windows Server 2003 Да
е Windows 2000 Server Да
р Windows NT Server Да  версии 4.0 и выше
в    
е    
р    
Используемая библиотека Psapi.lib
Используемая DLL -
 Заголовочный файл  
- объявлено в Psapi.h
 - включено в Psapi.h
 Unicode Реализовано как весии Unicode и ANSI.
 Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz