IDebugSymbols2::GetSourceFileLineOffsets-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetSourceFileLineOffsets- Methode ordnet jede Zeile in einer Quelldatei einem Speicherort im Speicher des Ziels zu.

Syntax

HRESULT GetSourceFileLineOffsets(
  [in]            PCSTR    File,
  [out, optional] PULONG64 Buffer,
  [in]            ULONG    BufferLines,
  [out, optional] PULONG   FileLines
);

Parameter

[in] File

Gibt den Namen der Datei an, deren Zeilen in Speicherorte im Speicher des Ziels umgewandelt werden. Die Symbole für jedes Modul im Ziel werden für diese Datei abgefragt. Wenn sich die Datei nicht befindet, wird der Pfad gelöscht, und die Symbole werden erneut abgefragt.

[out, optional] Buffer

Empfängt die Speicherorte im Speicher des Ziels, die den Zeilen des Quellcodes entsprechen. Der erste Eintrag, der an dieses Array zurückgegeben wird, entspricht der ersten Zeile der Datei, sodass Buffer[i] den Speicherort für Zeile i+1enthält. Wenn keine Symbolinformationen für eine Zeile verfügbar sind, wird der entsprechende Eintrag in Puffer- auf DEBUG_INVALID_OFFSET festgelegt. Wenn Puffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] BufferLines

Gibt die Anzahl der PULONG64 Objekte an, die das Buffer Array enthalten kann.

[out, optional] FileLines

Empfängt die Anzahl der Zeilen in der Quelldatei, die durch Fileangegeben wird.

Rückgabewert

Diese Methode kann auch 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. Die Anzahl der Zeilen in der Quelldatei hat jedoch die Anzahl der Einträge im Buffer Array überschritten, und einige der Ergebnisse wurden verworfen.