Compartir a través de

Función EnumerateLoadedModules (dbghelp.h)

  • Artículo

Enumera los módulos cargados para el proceso especificado.

Sintaxis

BOOL IMAGEAPI EnumerateLoadedModules(
  [in]           HANDLE                       hProcess,
  [in]           PENUMLOADED_MODULES_CALLBACK EnumLoadedModulesCallback,
  [in, optional] PVOID                        UserContext
);

Parámetros

[in] hProcess

Identificador del proceso cuyos módulos se enumerarán.

[in] EnumLoadedModulesCallback

Una función de devolución de llamada definida por la aplicación. Para obtener más información, vea EnumerateLoadedModulesProc64.

[in, optional] UserContext

Datos opcionales definidos por el usuario. Este valor se pasa a la función de devolución de llamada.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Para recuperar información de error extendida, llame a GetLastError.

Comentarios

Todas las funciones DbgHelp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.

Para llamar a la versión Unicode de esta función, EnumerateLoadedModulesW64, defina DBGHELP_TRANSLATE_TCHAR. EnumerateLoadedModulesW64 se define de la siguiente manera en DbgHelp.h.

BOOL
IMAGEAPI
EnumerateLoadedModulesW64(
    __in HANDLE hProcess,
    __in PENUMLOADED_MODULES_CALLBACKW64 EnumLoadedModulesCallback,
    __in PVOID UserContext
    );

#ifdef DBGHELP_TRANSLATE_TCHAR
    #define EnumerateLoadedModules64      EnumerateLoadedModulesW64
#endif

Esta función sustituye a la función EnumerateLoadedModules . Para obtener más información, consulte Compatibilidad con la plataforma actualizada. EnumerateLoadedModules se define de la siguiente manera en DbgHelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define EnumerateLoadedModules EnumerateLoadedModules64
#else
BOOL
IMAGEAPI
EnumerateLoadedModules(
    __in HANDLE hProcess,
    __in PENUMLOADED_MODULES_CALLBACK EnumLoadedModulesCallback,
    __in_opt PVOID UserContext
    );
#endif

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado dbghelp.h
Library Dbghelp.lib
Archivo DLL Dbghelp.dll
Redistribuible DbgHelp.dll 5.1 o posterior

Consulte también

Funciones de DbgHelp

EnumerateLoadedModulesProc64