структура MODULEENTRY32W (tlhelp32.h)

Описывает запись из списка модулей, принадлежащих указанному процессу.

Синтаксис

typedef struct tagMODULEENTRY32W {
  DWORD   dwSize;
  DWORD   th32ModuleID;
  DWORD   th32ProcessID;
  DWORD   GlblcntUsage;
  DWORD   ProccntUsage;
  BYTE    *modBaseAddr;
  DWORD   modBaseSize;
  HMODULE hModule;
  WCHAR   szModule[MAX_MODULE_NAME32 + 1];
  WCHAR   szExePath[MAX_PATH];
} MODULEENTRY32W;

Члены

dwSize

Размер структуры в байтах. Перед вызовом функции Module32First установите для этого элемента значение sizeof(MODULEENTRY32). Если не инициализировать dwSize, Module32First завершается ошибкой.

th32ModuleID

Этот элемент больше не используется и всегда имеет значение одного.

th32ProcessID

Идентификатор процесса, модули которого необходимо проверить.

GlblcntUsage

Количество нагрузки модуля, которое не имеет общего значения и обычно равно 0xFFFF.

ProccntUsage

Количество нагрузки модуля (аналогично GlblcntUsage), которое обычно не имеет общего значения и обычно равно 0xFFFF.

modBaseAddr

Базовый адрес модуля в контексте процесса владения.

modBaseSize

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

hModule

Дескриптор модуля в контексте процесса владения.

szModule[MAX_MODULE_NAME32 + 1]

Имя модуля.

szExePath[MAX_PATH]

Путь к модулю.

Замечания

Элементы modBaseAddr и hModule допустимы только в контексте процесса, указанного th32ProcessID.

Примеры

Пример использования MODULEENTRY32см. в разделе обход списка модулей.

Заметка

Заголовок tlhelp32.h определяет MODULEENTRY32 как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
заголовка	tlhelp32.h

См. также

Module32First

Module32Next