Heap32ListNext function

Retrieves information about the next heap that has been allocated by a process.

Syntax

BOOL Heap32ListNext(
  HANDLE       hSnapshot,
  LPHEAPLIST32 lphl
);

Parameters

hSnapshot

A handle to the snapshot returned from a previous call to the CreateToolhelp32Snapshot function.

lphl

A pointer to a HEAPLIST32 structure.

Return Value

Returns TRUE if the next entry of the heap list has been copied to the buffer or FALSE otherwise. The ERROR_NO_MORE_FILES error value is returned by the GetLastError function when no more entries in the heap list exist.

Remarks

To retrieve information about the first heap in a heap list, use the Heap32ListFirst function.

Examples

For an example, see Traversing the Heap List.

Requirements

   
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header tlhelp32.h
Library Kernel32.lib
DLL Kernel32.dll

See Also

CreateToolhelp32Snapshot

HEAPLIST32

Heap Lists and Heap Walking

Heap32ListFirst

Tool Help Functions