função de retorno de chamada PSYM_ENUMMODULES_CALLBACK (dbghelp.h)
Uma função de retorno de chamada definida pelo aplicativo usada com a função SymEnumerateModules64 . Ele é chamado uma vez para cada módulo enumerado e recebe as informações do módulo.
Os tipos PSYM_ENUMMODULES_CALLBACK64 e PSYM_ENUMMODULES_CALLBACKW64 definem um ponteiro para essa função de retorno de chamada. SymEnumerateModulesProc64 é um espaço reservado para o nome da função definida pelo aplicativo.
Sintaxe
PSYM_ENUMMODULES_CALLBACK PsymEnummodulesCallback;
BOOL PsymEnummodulesCallback(
[in] PCSTR ModuleName,
[in] ULONG BaseOfDll,
[in, optional] PVOID UserContext
)
{...}
Parâmetros
[in] ModuleName
O nome do módulo.
[in] BaseOfDll
O endereço base em que o módulo é carregado na memória.
[in, optional] UserContext
O valor definido pelo usuário especificado em SymEnumerateModules64 ou NULL. Normalmente, esse parâmetro é usado por um aplicativo para passar um ponteiro para uma estrutura de dados que permite que a função de retorno de chamada estabeleça algum tipo de contexto.
Retornar valor
Se o valor retornado for TRUE, a enumeração continuará.
Se o valor retornado for FALSE, a enumeração será interrompida.
Comentários
O aplicativo de chamada é chamado uma vez por módulo até que todos os módulos sejam enumerados ou até que a função de retorno de chamada de enumeração retorne FALSE.
Essa função de retorno de chamada substitui a função de retorno de chamada PSYM_ENUMMODULES_CALLBACK. PSYM_ENUMMODULES_CALLBACK é definido da seguinte maneira em DbgHelp.h.
#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PSYM_ENUMMODULES_CALLBACK PSYM_ENUMMODULES_CALLBACK64
#else
typedef BOOL
(CALLBACK *PSYM_ENUMMODULES_CALLBACK)(
__in PCSTR ModuleName,
__in ULONG BaseOfDll,
__in_opt PVOID UserContext
);
#endif
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | dbghelp.h |
| Redistribuível | DbgHelp.dll 5.1 ou posterior |