Функция 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, Функции, используемые DLL, EnumProcesses, 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.
Замечания по платформе		Не имеется

Назад в оглавление

На главную страницу

На оглавление справки