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

使用 Heap32FirstHeap32Next 遍走堆效率低下,尤其是对于大型堆。 请改用 HeapWalk

示例

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

要求

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

另请参阅

HEAPENTRY32

堆Lists和堆行走

Heap32First

工具帮助函数