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

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

  • Статья

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

Синтаксис

BOOL IMAGEAPI SymEnumSourceLines(
  [in]           HANDLE                  hProcess,
  [in]           ULONG64                 Base,
  [in, optional] PCSTR                   Obj,
  [in, optional] PCSTR                   File,
  [in, optional] DWORD                   Line,
  [in]           DWORD                   Flags,
  [in]           PSYM_ENUMLINES_CALLBACK 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, такие как эта, являются однопоточными. Поэтому вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.

Требования

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

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

Функции DbgHelp

SymEnumLinesProc

SymInitialize