SymGetLinePrev-Funktion (dbghelp.h)

Artikel
02/26/2024

Ruft die Zeileninformationen für die vorherige Quellzeile ab.

Syntax

BOOL IMAGEAPI SymGetLinePrev(
  [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 .

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 SymGetLinePrev64-Funktion erfordert, dass die IMAGEHLP_LINE64-Struktur über gültige Daten verfügt, die vermutlich aus einem Aufruf der SymGetLineFromAddr64 - oder SymGetLineFromName64-Funktion stammen. Diese Struktur wird nacheinander mit den Zeileninformationen für die vorherige Zeile gefüllt.

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

Alle DbgHelp-Funktionen, z. B. diese, sind single threaded. 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. SymGetLinePrevW64 wird in DbgHelp.h wie folgt definiert.

BOOL
IMAGEAPI
SymGetLinePrevW64(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_LINEW64 Line
    );

#ifdef DBGHELP_TRANSLATE_TCHAR
#define SymGetLinePrev64    SymGetLinePrevW64
#endif

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

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

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