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

  • Artigo

Uma função de retorno de chamada definida pelo aplicativo usada com a função EnumerateLoadedModules64 .

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

Sintaxe

PENUMLOADED_MODULES_CALLBACK PenumloadedModulesCallback;

BOOL PenumloadedModulesCallback(
  [in]           PCSTR ModuleName,
  [in]           ULONG ModuleBase,
  [in]           ULONG ModuleSize,
  [in, optional] PVOID UserContext
)
{...}

Parâmetros

[in] ModuleName

O nome do módulo enumerado.

[in] ModuleBase

O endereço base do módulo. Observe que é possível que esse endereço se torne inválido (por exemplo, o módulo pode ser descarregado). Use o tratamento de exceção ao acessar o endereço ou passar o endereço para outra função para evitar que uma violação de acesso ocorra.

[in] ModuleSize

O tamanho do módulo, em bytes.

[in, optional] UserContext

Dados opcionais definidos pelo usuário. Esse valor é passado de EnumerateLoadedModules64.

Valor retornado

Para continuar a enumeração, a função de retorno de chamada deve retornar TRUE.

Para interromper a enumeração, a função de retorno de chamada deve retornar FALSE.

Comentários

Essa função de retorno de chamada substitui a função de retorno de chamada PENUMLOADED_MODULES_CALLBACK. PENUMLOADED_MODULES_CALLBACK é definido da seguinte maneira em DbgHelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PENUMLOADED_MODULES_CALLBACK PENUMLOADED_MODULES_CALLBACK64
#else
typedef BOOL (CALLBACK *PENUMLOADED_MODULES_CALLBACK)(
    __in PCSTR ModuleName,
    __in ULONG ModuleBase,
    __in ULONG ModuleSize,
    __in_opt PVOID UserContext
    );
#endif

Requisitos

   
Plataforma de Destino Windows
Cabeçalho dbghelp.h
Redistribuível DbgHelp.dll 5.1 ou posterior

Confira também

Funções DbgHelp

EnumerateLoadedModules64