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

Статья
11/20/2024

Перечисляет все исходные строки в модуле.

Синтаксис

BOOL IMAGEAPI SymEnumSourceLinesW(
  [in]           HANDLE                   hProcess,
  [in]           ULONG64                  Base,
  [in, optional] PCWSTR                   Obj,
  [in, optional] PCWSTR                   File,
  [in, optional] DWORD                    Line,
  [in]           DWORD                    Flags,
  [in]           PSYM_ENUMLINES_CALLBACKW EnumLinesCallback,
  [in, optional] PVOID                    UserContext
);

Параметры

[in] hProcess

Дескриптор процесса. Этот дескриптор должен быть передан в функцию SymInitialize.

[in] Base

Базовый адрес модуля.

[in, optional] Obj

Имя файла .obj в модуле. Область перечисления ограничена этим файлом. Если этот параметр null или пустую строку, выполняется поиск всех .obj файлов.

[in, optional] File

Подстановочное выражение, указывающее имена исходных файлов для поиска. Если этот параметр значение NULL или пустую строку, поиск всех файлов выполняется.

[in, optional] Line

Номер строки строки в модуле. Область перечисления ограничена этой строкой. Если этот параметр равен 0, выполняется поиск всех строк.

[in] Flags

Если этот параметр ESLFLAG_FULLPATH, функция соответствует полному пути в параметре File.

[in] EnumLinesCallback

Функция обратного вызова SymEnumLinesProc, которая получает сведения о строке.

[in, optional] UserContext

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

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

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

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

Замечания

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

Заметка

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

Требования

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

См. также

функций DbgHelp

SymEnumLinesProc

SymInitialize

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