IDebugSymbols3::GetSourceFileLineOffsets-Methode (dbgeng.h)
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 die Datei nicht gefunden wird, 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 an dieses Array zurückgegebene Eintrag entspricht der ersten Zeile der Datei, sodass Buffer[i]
der Speicherort für Zeile i+1
enthalten ist. Wenn für eine Zeile keine Symbolinformationen verfügbar sind, wird der entsprechende Eintrag in Puffer auf DEBUG_INVALID_OFFSET festgelegt. Wenn BufferNULL ist, werden diese Informationen nicht zurückgegeben.
[in] BufferLines
Gibt die Anzahl der PULONG64 Objekte an, die das Pufferarray enthalten kann.
[out, optional] FileLines
Empfängt die Anzahl der Zeilen in der Quelldatei, die durch File angegeben wird.
Rückgabewert
Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .
Rückgabecode | BESCHREIBUNG |
---|---|
|
Die Methode war erfolgreich. |
|
Die Methode war erfolgreich. Die Anzahl der Zeilen in der Quelldatei überstieg jedoch die Anzahl der Einträge im Pufferarray , und einige der Ergebnisse wurden verworfen. |
Hinweise
Weitere Informationen zur Verwendung des Quellpfads finden Sie unter Verwenden von Quelldateien.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | dbgeng.h (dbgeng.h einschließen) |