Share via

Heap32Next

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

BOOL WINAPI Heap32Next(
  HANDLE hSnapshot,
  LPHEAPENTRY32 lphe
);

Parameters

  • hSnapshot
    [in] Handle to the snapshot returned from a previous call to the CreateToolhelp32Snapshot function.

    This parameter is specific to Windows Embedded CE.

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; it returns 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

Header tlhelp32.h
Library toolhelp.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ToolHelp Functions
CreateToolhelp32Snapshot
HEAPENTRY32
Heap32First