Heap32Next 函数 (tlhelp32.h)
检索有关进程分配的堆的下一个块的信息。
语法
BOOL Heap32Next(
[out] LPHEAPENTRY32 lphe
);
参数
[out] lphe
指向 HEAPENTRY32 结构的指针。
返回值
如果有关堆中下一个块的信息已复制到缓冲区,则返回 TRUE ,否则返回 FALSE 。 当堆中没有更多对象存在时,GetLastError 函数将返回ERROR_NO_MORE_FILES;如果堆看起来已损坏或在演练过程中以 Heap32Next 无法继续的方式进行修改,则ERROR_INVALID_DATA。
注解
若要检索堆的第一个块的信息,请使用 Heap32First 函数。
Heap32Next 函数不维护对目标进程的引用。 如果目标进程死亡,系统可能会使用相同的进程标识符创建一个新进程。 因此,调用方应保留对目标进程的引用,只要它使用的是 Heap32Next。
使用 Heap32First 和 Heap32Next 遍走堆效率低下,尤其是对于大型堆。 请改用 HeapWalk 。
示例
有关示例,请参阅 遍历堆列表。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | tlhelp32.h |
Library | Kernel32.lib |
DLL | Kernel32.dll |