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