Функция 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 или более поздней версии |