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


Функция 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 или более поздней версии

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

Функции DbgHelp