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

Статья
06.02.2025

Метод 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	Метод был успешным. Однако число строк в исходном файле превысило количество записей в массиве буфера, а некоторые результаты были отменены.