Функция FindDebugInfoFile (dbghelp.h)
Находит отладочный файл (DBG-файл).
Чтобы предоставить функцию обратного вызова для проверки расположения файла символов, используйте функцию 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 или более поздней версии |