Функция SymEnumSourceLinesW (dbghelp.h)
Перечисляет все строки источника в модуле.
Синтаксис
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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Библиотека | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Распространяемые компоненты | DbgHelp.dll 6.4 или более поздней версии |