Module32First 函数 (tlhelp32.h)

检索与进程关联的第一个模块的相关信息。

语法

BOOL Module32First(
  [in]      HANDLE          hSnapshot,
  [in, out] LPMODULEENTRY32 lpme
);

参数

[in] hSnapshot

快照的句柄,该句柄是从上次调用 CreateToolhelp32Snapshot 函数返回的。

[in, out] lpme

指向 MODULEENTRY32 结构的指针。

返回值

如果模块列表的第一个条目已复制到缓冲区,则返回 TRUE ,否则返回 FALSE 。 如果不存在模块或快照不包含模块信息,则 GetLastError 函数将返回ERROR_NO_MORE_FILES错误值。

注解

调用应用程序必须将 MODULEENTRY32dwSize 成员设置为 结构的大小(以字节为单位)。

若要检索与指定进程关联的其他模块的相关信息,请使用 Module32Next 函数。

示例

有关示例,请参阅 遍历模块列表

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 tlhelp32.h
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

CreateToolhelp32Snapshot

MODULEENTRY32

模块演练

Module32Next

工具帮助函数