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

Статья
02/26/2024

Метод 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. Если параметр Buffer имеет значение NULL, эти сведения не возвращаются.

[in] BufferLines

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

[out, optional] FileLines

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

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

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

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