Heap32ListFirst 函数 (tlhelp32.h)

项目
03/02/2024

检索有关指定进程分配的第一个堆的信息。

语法

BOOL Heap32ListFirst(
  [in]      HANDLE       hSnapshot,
  [in, out] LPHEAPLIST32 lphl
);

参数

[in] hSnapshot

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

[in, out] lphl

指向 HEAPLIST32 结构的指针。

返回值

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

注解

调用应用程序必须将 HEAPLIST32 的 dwSize 成员设置为结构的大小（以字节为单位）。 Heap32ListFirst 将 dwSize 更改为写入结构的字节数。这永远不会大于 dwSize 的初始值，但它可能更小。如果值较小，则不要依赖于偏移量大于此值的任何成员的值。

若要检索有关堆列表中其他堆的信息，请使用 Heap32ListNext 函数。

示例

有关示例，请参阅遍历堆列表。

要求

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