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

Статья
08/23/2023

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

Синтаксис

HANDLE IMAGEAPI FindDebugInfoFile(
  [in]  PCSTR FileName,
  [in]  PCSTR SymbolPath,
  [out] PSTR  DebugFilePath
);

Параметры

[in] FileName

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

[in] SymbolPath

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

[out] DebugFilePath

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

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

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

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

Функция FindDebugInfoFile используется для поиска DBG-файла. Эта функция предоставляется таким образом, чтобы поиск можно было выполнять в нескольких разных каталогах с помощью одного вызова функции. Параметр SymbolPath может содержать несколько путей, каждый из которых отделен точкой с запятой (;). Если указано несколько путей, функция выполняет поиск файла в каждом каталоге. В подкаталогах поиск не выполняется. Когда файл будет найден, поиск останавливается. Поэтому обязательно укажите SymbolPath с путями в правильном порядке.

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

Требования

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

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

Функции DbgHelp

FindDebugInfoFileEx

SymGetSearchPath

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