Heap32ListNext function (tlhelp32.h)

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

See also

CreateToolhelp32Snapshot

HEAPLIST32

Heap Lists and Heap Walking

Heap32ListFirst

Tool Help Functions