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

Статья
02/26/2024

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

[out, optional] FileBuffer

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

[in] FileBufferSize

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

[out, optional] FileSize

Указывает размер (в символах) имени исходного файла. Если fileSize имеет значение NULL, эти сведения не возвращаются.

[out, optional] Displacement

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

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

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

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