Heap32Next

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

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 Values

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.

Requirements

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CreateToolhelp32Snapshot, GetLastError, HEAPENTRY32, Heap32First

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.