Функция FindExecutableImage (dbghelp.h)

Статья
08/23/2023

Находит исполняемый файл.

Чтобы указать функцию обратного вызова, используйте функцию FindExecutableImageEx .

Синтаксис

HANDLE IMAGEAPI FindExecutableImage(
  [in]  PCSTR FileName,
  [in]  PCSTR SymbolPath,
  [out] PSTR  ImageFilePath
);

Параметры

[in] FileName

Имя файла символов, который необходимо найти. Этот параметр может быть частичным путем.

[in] SymbolPath

Путь к файлам символов. Это может быть несколько путей, разделенных точкой с запятой. Чтобы получить путь к символам, используйте функцию SymGetSearchPath .

[out] ImageFilePath

Указатель на буфер, получающий полный путь к исполняемому файлу.

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

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

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

Функция FindExecutableImage предоставляется таким образом, чтобы исполняемые файлы можно было размещать в нескольких разных каталогах с помощью одного вызова функции. Параметр SymbolPath может содержать несколько путей, каждый из которых отделен точкой с запятой (;). Если указано несколько путей, функция выполняет поиск исполняемого файла в каждом дереве каталогов. Когда файл будет найден, поиск останавливается. Поэтому обязательно укажите SymbolPath с путями в правильном порядке.

Все функции DbgHelp, такие как эта, являются однопоточными. Поэтому вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.

Требования


Целевая платформа	Windows
Header	dbghelp.h
Библиотека	Dbghelp.lib
DLL	Dbghelp.dll
Распространяемые компоненты	DbgHelp.dll 5.1 или более поздней версии

См. также раздел

Функции DbgHelp

FindExecutableImageEx

SymGetSearchPath

Поделиться через