SymGetLineNext-Funktion (dbghelp.h)

Artikel
08/23/2023

Ruft die Zeileninformationen für die nächste Quellzeile ab.

Syntax

BOOL IMAGEAPI SymGetLineNext(
  [in]      HANDLE         hProcess,
  [in, out] PIMAGEHLP_LINE Line
);

Parameter

[in] hProcess

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

[in, out] Line

Ein Zeiger auf eine IMAGEHLP_LINE64-Struktur , die die Zeileninformationen enthält.

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

Die SymGetLineNext64-Funktion erfordert, dass die IMAGEHLP_LINE64-Struktur über gültige Daten verfügt, die vermutlich aus einem Aufruf der SymGetLineFromAddr64 - oder SymGetLineFromName64-Funktion abgerufen werden. Diese Struktur empfängt die Zeileninformationen für die nächste Zeile in der Folge.

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. SymGetLineNextW64 ist in Dbghelp.h wie folgt definiert.


BOOL
IMAGEAPI
SymGetLineNextW64(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_LINEW64 Line

#ifdef DBGHELP_TRANSLATE_TCHAR
#define SymGetLineNext64  SymGetLineNextW64
#endif

Diese Funktion ersetzt die SymGetLineNext-Funktion . Weitere Informationen finden Sie unter Aktualisierte Plattformunterstützung. SymGetLineNext wird in Dbghelp.h wie folgt definiert.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetLineNext SymGetLineNext64
#else
BOOL
IMAGEAPI
SymGetLineNext(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_LINE Line
    );

BOOL
IMAGEAPI
SymGetLineNextW(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_LINEW Line
    );
#endif