Funzione SymGetLineNext (dbghelp.h)

Articolo
08/23/2023

Recupera le informazioni sulla riga per la riga di origine successiva.

Sintassi

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

Parametri

[in] hProcess

Handle per il processo passato originariamente alla funzione SymInitialize .

[in, out] Line

Puntatore a una struttura IMAGEHLP_LINE64 contenente le informazioni sulla riga.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

La funzione SymGetLineNext64 richiede che la struttura IMAGEHLP_LINE64 abbia dati validi, presumibilmente ottenuti da una chiamata alla funzione SymGetLineFromAddr64 o SymGetLineFromName64 . Questa struttura riceve le informazioni sulla riga per la riga successiva in sequenza.

Questa funzione restituisce un puntatore a un buffer che può essere riutilizzato da un'altra funzione. Assicurarsi quindi di copiare immediatamente i dati restituiti in un altro buffer.

Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Di conseguenza, le chiamate da più thread a questa funzione genereranno un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.

Per chiamare la versione Unicode di questa funzione, definire DBGHELP_TRANSLATE_TCHAR. SymGetLineNextW64 è definito come segue in Dbghelp.h.


BOOL
IMAGEAPI
SymGetLineNextW64(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_LINEW64 Line

#ifdef DBGHELP_TRANSLATE_TCHAR
#define SymGetLineNext64  SymGetLineNextW64
#endif

Questa funzione sostituisce la funzione SymGetLineNext . Per altre informazioni, vedere Aggiornamento del supporto della piattaforma. SymGetLineNext è definito come segue in Dbghelp.h.

#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

Requisiti


Piattaforma di destinazione	Windows
Intestazione	dbghelp.h
Libreria	Dbghelp.lib
DLL	Dbghelp.dll
Componente ridistribuibile	DbgHelp.dll 5.1 o versione successiva