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

Метод GetLineByOffset возвращает имя исходного файла и номер строки в исходном файле инструкции в целевом объекте.

Синтаксис

HRESULT GetLineByOffset(
  [in]            ULONG64  Offset,
  [out, optional] PULONG   Line,
  [out, optional] PSTR     FileBuffer,
  [in]            ULONG    FileBufferSize,
  [out, optional] PULONG   FileSize,
  [out, optional] PULONG64 Displacement
);

Параметры

[in] Offset

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

[out, optional] Line

Получает номер строки в исходном файле инструкции, указанной Offset. Если строкаNULL, эти сведения не возвращаются.

[out, optional] FileBuffer

Получает имя файла, содержащего инструкцию, указанную Offset. Если FileBufferNULL, эти сведения не возвращаются.

[in] FileBufferSize

Задает размер буфера FileBuffer в символах.

[out, optional] FileSize

Задает размер в символах исходного имени файла. Если FileSizeNULL, эти сведения не возвращаются.

[out, optional] Displacement

Получает разницу между расположением, указанным в Смещение и расположением первой инструкции возвращаемой строки. Если смещениеnull, эти сведения не возвращаются.

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

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

Замечания

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

Требования

См. также

GetOffsetByLine

IDebugSymbols

IDebugSymbols2

IDebugSymbols3