Heap32Next function (tlhelp32.h)

Retrieves information about the next block of a heap that has been allocated by a process.

Syntax

BOOL Heap32Next(
  [out] LPHEAPENTRY32 lphe
);

Parameters

[out] lphe

A pointer to a HEAPENTRY32 structure.

Return value

Returns TRUE if information about the next block in the heap has been copied to the buffer or FALSE otherwise. The GetLastError function returns ERROR_NO_MORE_FILES when no more objects in the heap exist and ERROR_INVALID_DATA if the heap appears to be corrupt or is modified during the walk in such a way that Heap32Next cannot continue.

Remarks

To retrieve information for the first block of a heap, use the Heap32First function.

The Heap32Next function does not maintain a reference to the target process. If the target process dies, the system may create a new process using the same process identifier. Therefore, the caller should maintain a reference to the target process as long as it is using Heap32Next.

Walking the heap with Heap32First and Heap32Next is inefficient, particularly for large heaps. Use HeapWalk instead.

Examples

For an example, see Traversing the Heap List.

Requirements

See also

HEAPENTRY32

Heap Lists and Heap Walking

Heap32First

Tool Help Functions