Funzione SymNext (dbghelp.h)

Recupera le informazioni sui simboli per il simbolo successivo.

Sintassi

BOOL IMAGEAPI SymNext(
  [in]      HANDLE       hProcess,
  [in, out] PSYMBOL_INFO si
);

Parametri

[in] hProcess

Handle a un processo. Questo handle deve essere stato passato in precedenza alla funzione SymInitialize .

[in, out] si

Puntatore a una struttura SYMBOL_INFO che fornisce informazioni sul simbolo corrente. Al ritorno, la struttura contiene informazioni sul simbolo successivo.

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

Questa funzione richiede che la struttura SYMBOL_INFO disponga di dati validi per il simbolo corrente. Il simbolo successivo è il simbolo con l'indirizzo virtuale che si trova accanto nella sequenza.

Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Pertanto, le chiamate da più thread a questa funzione potrebbero causare 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.

Requisiti

Vedi anche

Funzioni DbgHelp

SYMBOL_INFO

SymPrev