Função de retorno de chamada PENUMSOURCEFILETOKENSCALLBACK (dbghelp.h)

Artigo
08/23/2023

Uma função de retorno de chamada definida pelo aplicativo usada com a função SymEnumSourceFileTokens que enumera as informações de controle de versão do servidor de origem armazenadas no PDB para um módulo.

O tipo PENUMSOURCEFILETOKENSCALLBACK define um ponteiro para essa função de retorno de chamada. SymEnumSourceFileTokensProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PENUMSOURCEFILETOKENSCALLBACK Penumsourcefiletokenscallback;

BOOL Penumsourcefiletokenscallback(
  [in] PVOID token,
  [in] size_t size
)
{...}

Parâmetros

[in] token

Um ponteiro para uma estrutura de dados opaca que contém as informações de controle de versão correspondentes a um arquivo de origem individual específico. O uso desse token é detalhado abaixo.

[in] size

O tamanho dos dados no parâmetro de token .

Valor retornado

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

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

Comentários

Um aplicativo pode usar esse token para extrair um arquivo de origem do controle de versão chamando SymGetSourceFileFromToken.

Para obter variáveis individuais do token, chame SymGetSourceVarFromToken. Os nomes das variáveis diferem com base nos scripts usados para criar os tokens. Consulte Servidor de Origem para obter detalhes.