Platform SDK: Debugging and Error Handling

Heap32Next

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

BOOL WINAPI Heap32Next(
  LPHEAPENTRY32 lphe  
);

Parameters

lphe
[out] Pointer to a HEAPENTRY32 structure.

Return Values

Returns TRUE if information about the next block in the heap has been copied to the buffer or FALSE otherwise. The GetLastError function returns ERROR_NO_MORE_FILES when no more objects in the heap exist and ERROR_INVALID_DATA if the heap appears to be corrupt or is modified during the walk in such a way that Heap32Next cannot continue.

Remarks

To retrieve information for the first block of a heap, use the Heap32First 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