Heap32Next

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.

• lphe
  [out] 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; 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

See Also

Reference

ToolHelp Functions
CreateToolhelp32Snapshot
HEAPENTRY32
Heap32First