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

Статья
11/20/2024

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

Синтаксис

HANDLE IMAGEAPI FindExecutableImageExW(
  [in]           PCWSTR                   FileName,
  [in]           PCWSTR                   SymbolPath,
  [out]          PWSTR                    ImageFilePath,
  [in, optional] PFIND_EXE_FILE_CALLBACKW Callback,
  [in, optional] PVOID                    CallerData
);

Параметры

[in] FileName

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

[in] SymbolPath

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

[out] ImageFilePath

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

[in, optional] Callback

Функция обратного вызова, определяемая приложением, проверяет, найден ли правильный исполняемый файл или должен ли функция продолжить поиск. Дополнительные сведения см. в разделе FindExecutableImageProc.

Этот параметр может быть NULL.

[in, optional] CallerData

Необязательные пользовательские данные для функции обратного вызова. Этот параметр может быть NULL.

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

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

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

Замечания

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

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

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

Заметка

Заголовок dbghelp.h определяет FindExecutableImageEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	dbghelp.h
библиотеки	Dbghelp.lib
DLL	Dbghelp.dll
распространяемый	DbgHelp.dll 5.1 или более поздней версии

См. также

функций DbgHelp

FindExecutableImageProc

SymGetSearchPath

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