Retrieves information about the next block of a heap that has been allocated by a process.
BOOL Heap32Next( LPHEAPENTRY32 lphe );
A pointer to a HEAPENTRY32 structure.
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.
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.
For an example, see Traversing the Heap List.
|Minimum supported client||Windows XP [desktop apps only]|
|Minimum supported server||Windows Server 2003 [desktop apps only]|