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


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

Находит DBG-файл в пути поиска процесса.

Синтаксис

HANDLE IMAGEAPI SymFindDebugInfoFile(
  [in]           HANDLE                    hProcess,
  [in]           PCSTR                     FileName,
  [out]          PSTR                      DebugFilePath,
  [in, optional] PFIND_DEBUG_FILE_CALLBACK Callback,
  [in, optional] PVOID                     CallerData
);

Параметры

[in] hProcess

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

[in] FileName

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

[out] DebugFilePath

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

[in, optional] Callback

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

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

[in, optional] CallerData

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

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

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

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

Комментарии

Эта функция использует путь поиска, заданный с помощью функции SymInitialize или SymSetSearchPath .

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

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

Требования

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

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

Функции DbgHelp

FindDebugInfoFileProc