Função SymSetContext (dbghelp.h)
Define as informações de contexto usadas pela função SymEnumSymbols . Essa função só funciona com símbolos PDB.
Sintaxe
BOOL IMAGEAPI SymSetContext(
[in] HANDLE hProcess,
[in] PIMAGEHLP_STACK_FRAME StackFrame,
[in, optional] PIMAGEHLP_CONTEXT Context
);
Parâmetros
[in] hProcess
Um identificador para um processo. Esse identificador deve ter sido passado anteriormente para a função SymInitialize .
[in] StackFrame
Um ponteiro para uma estrutura IMAGEHLP_STACK_FRAME que contém informações de quadro.
[in, optional] Context
Este parâmetro é ignorado.
Retornar valor
Se a função for bem-sucedida, o valor retornado será TRUE.
Se a função falhar, o valor retornado será FALSE. Para recuperar informações de erro estendidas, chame GetLastError.
Comentários
Se você chamar SymSetContext para definir o contexto como seu valor atual, a função falhará, mas GetLastError retornará ERROR_SUCCESS.
Todas as funções DbgHelp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | dbghelp.h |
| Biblioteca | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Redistribuível | DbgHelp.dll 5.1 ou posterior |