Поделиться через

Функция EnumerateLoadedModules (dbghelp.h)

  • Статья

Перечисляет загруженные модули для указанного процесса.

Синтаксис

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

Параметры

[in] hProcess

Дескриптор процесса, модули которого будут перечисляться.

[in] EnumLoadedModulesCallback

Определяемая приложением функция обратного вызова. Дополнительные сведения см. в разделе EnumerateLoadedModulesProc64.

[in, optional] UserContext

Необязательные пользовательские данные. Это значение передается в функцию обратного вызова.

Возвращаемое значение

Если функция выполнена успешно, возвращается значение TRUE.

Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.

Комментарии

Все функции DbgHelp, такие как эта, являются однопоточными. Таким образом, вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.

Чтобы вызвать версию Юникода этой функции EnumerateLoadedModulesW64, определите DBGHELP_TRANSLATE_TCHAR. EnumerateLoadedModulesW64 определяется в DbgHelp.h следующим образом.

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

#ifdef DBGHELP_TRANSLATE_TCHAR
    #define EnumerateLoadedModules64      EnumerateLoadedModulesW64
#endif

Эта функция заменяет функцию EnumerateLoadedModules . Дополнительные сведения см. в разделе Обновленная поддержка платформы. EnumerateLoadedModules определяется в 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

Требования

Требование Значение
Целевая платформа Windows
Header dbghelp.h
Библиотека Dbghelp.lib
DLL Dbghelp.dll
Распространяемые компоненты DbgHelp.dll 5.1 или более поздней версии

См. также раздел

Функции DbgHelp

EnumerateLoadedModulesProc64