Platform SDK: Debugging and Error Handling

Heap32ListNext

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

BOOL WINAPI Heap32ListNext(
  HANDLE hSnapshot,  
  LPHEAPLIST32 lphl  
);

Parameters

hSnapshot
[in] Handle to the snapshot returned from a previous call to the CreateToolhelp32Snapshot function.
lphl
[out] Pointer to a HEAPLIST32 structure.

Return Values

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.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Tlhelp32.h.
  Library: Use Kernel32.lib.

See Also

Tool Help Library Overview, Tool Help Functions