Heap32ListNext

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

BOOL WINAPI Heap32ListNext(
  HANDLE hSnapshot,  
  LPHEAPLIST32 lphl  
);

Parameters

hSnapshot

Handle to the snapshot returned from a previous call to the CreateToolhelp32Snapshot function.

lphl

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.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in tlhelp32.h.
  Import Library: Use kernel32.lib.

See Also

Tool Help Library Overview, Tool Help Functions