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

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

Syntax

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

Parameters

[in] hProcess

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

[in] FileName

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

[out] ImageFilePath

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

[in] Callback

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

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

[in] CallerData

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

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

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

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

Замечания

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

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

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

Требования

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

См. также

функций DbgHelp

FindExecutableImageProc