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

Статья
08/23/2023

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

Синтаксис

HANDLE IMAGEAPI SymFindExecutableImage(
  [in]  HANDLE                  hProcess,
  [in]  PCSTR                   FileName,
  [out] PSTR                    ImageFilePath,
  [in]  PFIND_EXE_FILE_CALLBACK Callback,
  [in]  PVOID                   CallerData
);

Параметры

[in] hProcess

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

[in] FileName

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

[out] ImageFilePath

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

[in] Callback

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

Этот параметр может принимать значение NULL.

[in] CallerData

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

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

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

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

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

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

Требования

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

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

Функции DbgHelp

FindExecutableImageProc

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