Funzione SymGetLineNext (dbghelp.h)
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 |