IDebugSymbols3::GetLineByOffsetWide-Methode (dbgeng.h)

Artikel
02/26/2024

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

Syntax

HRESULT GetLineByOffsetWide(
  [in]            ULONG64  Offset,
  [out, optional] PULONG   Line,
  [out, optional] PWSTR    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 LineNULL 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 den Unterschied zwischen der in Offset angegebenen Position und der Position der ersten Anweisung der zurückgegebenen Zeile. Wenn die VerschiebungNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode gibt möglicherweise auch andere Fehlerwerte zurück. 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.

Hinweise

Weitere Informationen zu Quelldateien finden Sie unter Verwenden von Quelldateien.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (dbgeng.h einschließen)

Weitere Informationen

GetOffsetByLine

IDebugSymbols3