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

Статья
11/20/2024

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

Синтаксис

HANDLE IMAGEAPI SymFindExecutableImageW(
  [in]  HANDLE                   hProcess,
  [in]  PCWSTR                   FileName,
  [out] PWSTR                    ImageFilePath,
  [in]  PFIND_EXE_FILE_CALLBACKW Callback,
  [in]  PVOID                    CallerData
);

Параметры

[in] hProcess

Дескриптор процесса, который был первоначально передан в функцию SymInitialize.

[in] FileName

Имя исполняемого файла. Можно использовать частичный путь.

[out] ImageFilePath

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

[in] Callback

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

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

[in] CallerData

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

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

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

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

Замечания

Эта функция использует набор пути поиска с помощью функции SymInitialize или SymSetSearchPath.

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

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

Заметка

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

Требования

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

См. также

функций DbgHelp

FindExecutableImageProc

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