Retrieves information about the first module associated with a process.
Syntax
BOOL WINAPI Module32First(
__in HANDLE hSnapshot,
__inout LPMODULEENTRY32 lpme
);
Parameters
- hSnapshot [in]
-
A handle to the snapshot returned from a previous call to the
CreateToolhelp32Snapshot function.
- lpme [in, out]
-
A pointer to a
MODULEENTRY32 structure.
Return Value
Returns TRUE if the first entry of the module list has been copied to the buffer or FALSE otherwise. The ERROR_NO_MORE_FILES error value is returned by the
GetLastError function if no modules exist or the snapshot does not contain module information.
Remarks
The calling application must set the dwSize member of
MODULEENTRY32 to the size, in bytes, of the structure.
To retrieve information about other modules associated with the specified process, use the
Module32Next function.
Examples
For an example, see
Traversing the Module List.
Requirements
| Minimum supported client | Windows 2000 Professional |
|---|
| Minimum supported server | Windows 2000 Server |
|---|
| Header | Tlhelp32.h |
|---|
| Library | Kernel32.lib |
|---|
| DLL | Kernel32.dll |
|---|
| Unicode and ANSI names | Module32FirstW (Unicode) and Module32First (ANSI) |
|---|
See Also
- CreateToolhelp32Snapshot
- Module Walking
- Module32Next
- MODULEENTRY32
- Tool Help Functions
Send comments about this topic to Microsoft
Build date: 7/2/2009