PSYM_ENUMERATESYMBOLS_CALLBACK função de retorno de chamada (dbghelp.h)

Artigo
08/23/2023

Uma função de retorno de chamada definida pelo aplicativo usada com as funções SymEnumSymbols, SymEnumTypes e SymEnumTypesByName .

Os tipos PSYM_ENUMERATESYMBOLS_CALLBACK e PSYM_ENUMERATESYMBOLS_CALLBACKW definem um ponteiro para essa função de retorno de chamada. SymEnumSymbolsProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PSYM_ENUMERATESYMBOLS_CALLBACK PsymEnumeratesymbolsCallback;

BOOL PsymEnumeratesymbolsCallback(
  [in]           PSYMBOL_INFO pSymInfo,
  [in]           ULONG SymbolSize,
  [in, optional] PVOID UserContext
)
{...}

Parâmetros

[in] pSymInfo

Um ponteiro para uma estrutura SYMBOL_INFO que fornece informações sobre o símbolo.

[in] SymbolSize

O tamanho do símbolo, em bytes. O tamanho é calculado e, na verdade, é um palpite. Em alguns casos, esse valor pode ser zero.

[in, optional] UserContext

O valor definido pelo usuário passado da função SymEnumSymbols ou SymEnumTypes ou NULL. Esse parâmetro normalmente é usado por um aplicativo para passar um ponteiro para uma estrutura de dados que fornece informações de contexto para a função de retorno de chamada.