Heap32ListFirst 函数 (tlhelp32.h)
检索有关指定进程分配的第一个堆的信息。
语法
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 |