Heap32Next

This function retrieves information about the next block of a heap that has been allocated by a process.

At a Glance

Header file: Tlhelp32.h
Windows CE versions: 2.0 and later

Syntax

BOOL WINAPI Heap32Next( HANDLE hSnapshot,
LPHEAPENTRY32 lphe);

Parameters

hSnapShot

Handle to the snapshot returned from a previous call to the CreateToolhelp32Snapshot function. This parameter is specific to Windows CE.

lphe

Long pointer to a HEAPENTRY32 structure.

Return Value

TRUE indicates that information about the next block in the heap has been copied to the buffer. FALSE indicates failure. 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.