Функция SymEnumLines (dbghelp.h)
Перечисляет все строки в указанном модуле.
Синтаксис
BOOL IMAGEAPI SymEnumLines(
[in] HANDLE hProcess,
[in] ULONG64 Base,
[in, optional] PCSTR Obj,
[in, optional] PCSTR File,
[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] EnumLinesCallback
Функция обратного вызова SymEnumLinesProc , которая получает сведения о строке.
[in, optional] UserContext
Определяемое пользователем значение, передаваемое в функцию обратного вызова, или NULL. Этот параметр обычно используется приложением для передачи указателя на структуру данных, которая предоставляет контекст для функции обратного вызова.
Возвращаемое значение
Если функция выполнена успешно, возвращается значение TRUE.
Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.
Комментарии
Эта функция поддерживается только для сведений PDB. Если у вас есть сведения о COFF, попробуйте использовать одну из функций SymGetLineXXX .
Все функции DbgHelp, такие как эта, являются однопоточными. Таким образом, вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.
Чтобы вызвать версию юникода этой функции, определите DBGHELP_TRANSLATE_TCHAR.
Требования
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Библиотека | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Распространяемые компоненты | DbgHelp.dll 6.1 или более поздней версии |