Функция SymGetFileLineOffsets64 (dbghelp.h)
Находит сведения о строке для указанного модуля и имени файла.
Синтаксис
ULONG IMAGEAPI SymGetFileLineOffsets64(
[in] HANDLE hProcess,
[in, optional] PCSTR ModuleName,
[in] PCSTR FileName,
[out] PDWORD64 Buffer,
[in] ULONG BufferLines
);
Параметры
[in] hProcess
Дескриптор процесса, который изначально был передан функции SymInitialize .
[in, optional] ModuleName
Имя модуля, в котором должны находиться строки. Если этот параметр имеет значение NULL, функция выполняет поиск по всем модулям.
[in] FileName
Имя файла, в котором должны находиться строки.
[out] Buffer
Массив смещений для каждой строки. Смещение строки n хранится в элементе n-1. Элементы массива для строк, не имеющих сведений о строках, остаются без изменений.
[in] BufferLines
Размер массива Buffer в элементах.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение — это самый высокий найденный номер строки. Это значение равно нулю, если сведения о строке не найдены.
Если функция завершается сбоем, возвращаемое значение LINE_ERROR. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.
Комментарии
Все функции DbgHelp, такие как эта, являются однопоточными. Таким образом, вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Библиотека | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Распространяемые компоненты | DbgHelp.dll 5.1 или более поздней версии |