Funzione SymSetContext (dbghelp.h)

  • Articolo

Imposta le informazioni di contesto utilizzate dalla funzione SymEnumSymbols . Questa funzione funziona solo con i simboli PDB.

Sintassi

BOOL IMAGEAPI SymSetContext(
  [in]           HANDLE                hProcess,
  [in]           PIMAGEHLP_STACK_FRAME StackFrame,
  [in, optional] PIMAGEHLP_CONTEXT     Context
);

Parametri

[in] hProcess

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

[in] StackFrame

Puntatore a una struttura IMAGEHLP_STACK_FRAME che contiene informazioni sul frame.

[in, optional] Context

Questo parametro viene ignorato.

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

Se si chiama SymSetContext per impostare il contesto sul valore corrente, la funzione ha esito negativo, ma GetLastError restituisce ERROR_SUCCESS.

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.

Requisiti

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

Vedi anche

Funzioni DbgHelp

IMAGEHLP_STACK_FRAME

SymEnumSymbols