Метод IDebugSymbols2::GetSourceFileLineOffsets (dbgeng.h)

Метод GetSourceFileLineOffsets сопоставляет каждую строку в исходном файле с расположением в памяти целевого объекта.

Синтаксис

HRESULT GetSourceFileLineOffsets(
  [in]            PCSTR    File,
  [out, optional] PULONG64 Buffer,
  [in]            ULONG    BufferLines,
  [out, optional] PULONG   FileLines
);

Параметры

[in] File

Указывает имя файла, строки которого будут преобразованы в расположения в памяти целевого объекта. Символы для каждого модуля в целевом объекте запрашиваются для этого файла. Если файл не расположен, путь удаляется и символы запрашиваются снова.

[out, optional] Buffer

Получает расположения в памяти целевого объекта, соответствующие строкам исходного кода. Первая запись, возвращенная в этот массив, соответствует первой строке файла, поэтому Buffer[i] содержит расположение для строки i+1. Если для строки нет сведений о символах, соответствующая запись в буфере имеет значение DEBUG_INVALID_OFFSET. Если буферnull, эти сведения не возвращаются.

[in] BufferLines

Указывает количество объектов PULONG64, которые может хранить массив буфера.

[out, optional] FileLines

Получает количество строк в исходном файле, заданное file.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.

Возвращаемый код Описание
S_OK
 Метод был успешным.
S_FALSE
 Метод был успешным. Однако число строк в исходном файле превысило количество записей в массиве буфера, а некоторые результаты были отменены.

Замечания

Дополнительные сведения об использовании пути к источнику см. в разделе Использование исходных файлов.

Требования

Требование Ценность
целевая платформа Настольный
заголовка dbgeng.h (include Dbgeng.h)

См. также

FindSourceFile

GetSourceEntriesByLine

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

  • Last updated on