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.