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

Статья
11/20/2024

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

Синтаксис

HANDLE IMAGEAPI SymFindDebugInfoFileW(
  [in]           HANDLE                     hProcess,
  [in]           PCWSTR                     FileName,
  [out]          PWSTR                      DebugFilePath,
  [in, optional] PFIND_DEBUG_FILE_CALLBACKW 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.

Заметка

Заголовок dbghelp.h определяет SymFindDebugInfoFile в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

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

См. также

функций DbgHelp

FindDebugInfoFileProc

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