Compartilhar via


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

Uma função de retorno de chamada definida pelo aplicativo usada com as funções SymEnumSymbols, SymEnumTypese 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_CALLBACKW PsymEnumeratesymbolsCallbackw;

BOOL PsymEnumeratesymbolsCallbackw(
  [in]           PSYMBOL_INFOW 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.

Valor de retorno

Se a função retornar TRUE, a enumeração continuará.

Se a função retornar FALSE, a enumeração será interrompida.

Observações

Nota

O cabeçalho dbghelp.h define PSYM_ENUMERATESYMBOLS_CALLBACK como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
da Plataforma de Destino Windows
cabeçalho dbghelp.h
redistribuível DbgHelp.dll 5.1 ou posterior

Consulte também

do DbgHelp Functions

SYMBOL_INFO

SymEnumSymbols

SymEnumTypes

SymEnumTypesByName