SymGetLineFromInlineContext-Funktion (dbghelp.h)

Artikel
08/23/2023

Sucht die Quellzeile für den angegebenen Inlinekontext.

Syntax

BOOL IMAGEAPI SymGetLineFromInlineContext(
  [in]           HANDLE           hProcess,
  [in]           DWORD64          qwAddr,
  [in]           ULONG            InlineContext,
  [in, optional] DWORD64          qwModuleBaseAddress,
  [out]          PDWORD           pdwDisplacement,
  [out]          PIMAGEHLP_LINE64 Line64
);

Parameter

[in] hProcess

Ein Handle für den Prozess, der ursprünglich an die SymInitialize-Funktion übergeben wurde.

[in] qwAddr

Die Adresse, für die sich eine Zeile befinden soll. Es ist nicht erforderlich, dass sich die Adresse an einer Zeilengrenze befindet. Wenn die Adresse nach dem Anfang einer Zeile und vor dem Ende der Zeile angezeigt wird, wird die Zeile gefunden.

[in] InlineContext

Der Inlinekontext.

[in, optional] qwModuleBaseAddress

Die Basisadresse des Moduls.

[out] pdwDisplacement

Die Verschiebung in Bytes vom Anfang der Zeile oder null.

[out] Line64

Ein Zeiger auf eine IMAGEHLP_LINE64-Struktur .

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Der Aufrufer muss den Zeilenpuffer ordnungsgemäß zuordnen und die erforderlichen Member der IMAGEHLP_LINE64-Struktur ausfüllen, bevor SymGetLineFromInlineContext aufgerufen wird.

Diese Funktion gibt einen Zeiger auf einen Puffer zurück, der von einer anderen Funktion wiederverwendet werden kann. Achten Sie daher darauf, die zurückgegebenen Daten sofort in einen anderen Puffer zu kopieren.

Alle DbgHelp-Funktionen, z. B. diese, sind singlethreaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, müssen Sie alle an diese Funktion gerichteten gleichzeitigen Aufrufe mehrerer Threads synchronisieren.

Um die Unicode-Version dieser Funktion aufzurufen, definieren Sie DBGHELP_TRANSLATE_TCHAR. SymGetLineFromInlineContext ist in Dbghelp.h wie folgt definiert.

BOOL
IMAGEAPI
SymGetLineFromInlineContextW(
    _In_ HANDLE hProcess,
    _In_ DWORD64 dwAddr,
    _In_ ULONG InlineContext,
    _In_opt_ DWORD64 qwModuleBaseAddress,
    _Out_ PDWORD pdwDisplacement,
    _Out_ PIMAGEHLP_LINEW64 Line
    );

#ifdef DBGHELP_TRANSLATE_TCHAR
 #define SymGetLineFromInlineContext SymGetLineFromInlineContextW
#endif

Anforderungen


Zielplattform	Windows
Kopfzeile	dbghelp.h
Bibliothek	DbgHelp.lib
DLL	DbgHelp.dll
Verteilbare Komponente	DbgHelp.dll 6.2 oder höher

Freigeben über