IDebugSymbols3::GetLineByOffsetWide-Methode (dbgeng.h)

Die GetLineByOffsetWide Methode gibt den Quelldateinamen und die Zeilennummer innerhalb 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 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.

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.

Bemerkungen

Weitere Informationen zu Quelldateien finden Sie unter Verwenden von Quelldateien.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Siehe auch

GetOffsetByLine-

IDebugSymbols3