Heap32ListNext function (tlhelp32.h)

Article
02/22/2024

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

Syntax

BOOL Heap32ListNext(
  [in]  HANDLE       hSnapshot,
  [out] LPHEAPLIST32 lphl
);

Parameters

[in] hSnapshot

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

[out] 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

Requirement	Value
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