Heap32ListNext function

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

Syntax


BOOL WINAPI Heap32ListNext(
  _In_   HANDLE hSnapshot,
  _Out_  LPHEAPLIST32 lphl
);

Parameters

hSnapshot [in]

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

lphl [out]

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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

TlHelp32.h

Library

Kernel32.lib

DLL

Kernel32.dll

See also

CreateToolhelp32Snapshot
Heap Lists and Heap Walking
Heap32ListFirst
HEAPLIST32
Tool Help Functions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft