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


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

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

Чтобы указать функцию обратного вызова, используйте функцию 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