Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure describes an entry from a list that enumerates the modules used by a specified process.

Syntax

typedef struct tagMODULEENTRY32 {
  DWORD 
dwSize;
  DWORD 
th32ModuleID;
  DWORD 
th32ProcessID;
  DWORD 
GlblcntUsage;
  DWORD 
ProccntUsage;
  BYTE *
modBaseAddr;
  DWORD 
modBaseSize;
  HMODULE 
hModule;
  TCHAR 
szModule[MAX_PATH];
  TCHAR 
szExePath[MAX_PATH];
  DWORD 
dwFlags;
} MODULEENTRY32, *PMODULEENTRY32, *LPMODULEENTRY32;

Members

dwSize

Length, in bytes, of the structure.

Before calling the Module32Firstfunction, set this member to sizeof(MODULEENTRY32).

If you do not initialize dwSize, Module32Firstfails.

th32ModuleID

Module identifier in the context of the owning process.

The contents of this member are meaningful only to the tool help functions.

This member is not a handle, nor is it usable by Microsoft Win32® API elements.

th32ProcessID

Identifier of the process being examined.

The contents of this member can be used by Win32 API elements.

GlblcntUsage

Global usage count on the module.

ProccntUsage

Module usage count in the context of the owning process.

modBaseAddr

Base address of the module in the context of the owning process.

modBaseSize

Size, in bytes, of the module.

hModule

Handle to the module in the context of the owning process.

szModule

Null-terminated string that contains the module name.

szExePath

Null-terminated string that contains the location, or path, of the module.

dwFlags

Reserved.

Remarks

The modBaseAddrand hModulemembers are valid only in the context of the process specified by th32ProcessID.

Requirements

Header tlhelp32.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ToolHelp Structures
Module32First

Other Resources