функция обратного вызова PENUMLOADED_MODULES_CALLBACK (dbghelp.h)

Статья
08/23/2023

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

Типы PENUMLOADED_MODULES_CALLBACK64 и PENUMLOADED_MODULES_CALLBACKW64 определяют указатель на эту функцию обратного вызова. EnumerateLoadedModulesProc64 — это заполнитель для имени определяемой приложением функции.

Синтаксис

PENUMLOADED_MODULES_CALLBACK PenumloadedModulesCallback;

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

Параметры

[in] ModuleName

Имя перечисленного модуля.

[in] ModuleBase

Базовый адрес модуля. Обратите внимание, что этот адрес может стать недопустимым (например, модуль может быть выгружен). Используйте обработку исключений при доступе к адресу или передаче адреса в другую функцию, чтобы предотвратить нарушение доступа.

[in] ModuleSize

Размер модуля в байтах.

[in, optional] UserContext

Необязательные пользовательские данные. Это значение передается из EnumerateLoadedModules64.

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

Чтобы продолжить перечисление, функция обратного вызова должна возвращать значение TRUE.

Чтобы остановить перечисление, функция обратного вызова должна возвращать значение FALSE.

#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

Требования


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

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

Функции DbgHelp

EnumerateLoadedModules64

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