IDebugSymbols3::GetLineByOffset-Methode (dbgeng.h)

Artikel
02/26/2024

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 durch Offset angegebenen Anweisung. Wenn ZeileNULL ist, werden diese Informationen nicht zurückgegeben.

[out, optional] FileBuffer

Empfängt den Dateinamen der Datei, die die durch Offset angegebene Anweisung enthält. Wenn FileBufferNULL 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 FileSizeNULL ist, werden diese Informationen nicht zurückgegeben.

[out, optional] Displacement

Empfängt die Differenz zwischen der in Offset angegebenen Position und der Position der ersten Anweisung der zurückgegebenen Zeile. Wenn VerschiebungNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

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

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Der Puffer war jedoch nicht groß genug, um den Namen der Quelldatei aufzunehmen, und der Name wurde abgeschnitten.