IDebugSymbols2::GetLineByOffset-Methode (dbgeng.h)

Die GetLineByOffset Methode gibt den Quelldateinamen und die Zeilennummer in der Quelldatei einer Anweisung im Ziel zurück.

Syntax

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

Parameter

[in] Offset

Gibt den Speicherort im virtuellen Adressraum des Ziels der Anweisung an, für die die Quelldatei und die Zeilennummer zurückgegeben werden sollen.

[out, optional] Line

Empfängt die Zeilennummer in der Quelldatei der Anweisung, die durch Offsetangegeben wird. Wenn ZeileNULL-ist, werden diese Informationen nicht zurückgegeben.

[out, optional] FileBuffer

Empfängt den Dateinamen der Datei, die die durch Offsetangegebene Anweisung enthält. Wenn FileBuffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] FileBufferSize

Gibt die Größe des FileBuffer- Puffers in Zeichen an.

[out, optional] FileSize

Gibt die Größe des Quelldateinamens in Zeichen an. Wenn FileSize-NULL-ist, werden diese Informationen nicht zurückgegeben.

[out, optional] Displacement

Empfängt den Unterschied zwischen der in Offset angegebenen Position und der Position der ersten Anweisung der zurückgegebenen Zeile. Wenn Verdrängungs-NULL-ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode kann auch andere Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Bemerkungen

Weitere Informationen zu Quelldateien finden Sie unter Verwenden von Quelldateien.

Anforderungen

Siehe auch

GetOffsetByLine-

IDebugSymbols

IDebugSymbols2

IDebugSymbols3