HEAPENTRY32

Describes one entry (block) of a heap that is being examined.

typedef struct tagHEAPENTRY32 
{ 
    DWORD  dwSize; 
    HANDLE hHandle; 
    DWORD  dwAddress; 
    DWORD  dwBlockSize; 
    DWORD  dwFlags; 
    DWORD  dwLockCount; 
    DWORD  dwResvd; 
    DWORD  th32ProcessID; 
    DWORD  th32HeapID; 
} HEAPENTRY32; 
typedef HEAPENTRY32 *  PHEAPENTRY32; 
typedef HEAPENTRY32 *  LPHEAPENTRY32; 
 

Members

dwSize

Specifies the length, in bytes, of the structure. Before calling the Heap32First function, set this member to sizeof(HEAPENTRY32). If you do not initialize dwSize, Heap32First will fail.

hHandle

Handle to the heap block.

dwAddress

Linear address of the start of the block.

dwBlockSize

Size, in bytes, of the heap block.

dwFlags

Flags. These values are defined:

LF32_FIXED	The memory block has a fixed (unmovable) location.
LF32_FREE	The memory block is not used.
LF32_MOVEABLE	The memory block location can be moved.

dwLockCount

Lock count on the memory block. The lock count is incremented each time the GlobalLock or LocalLock function is called on the block either by the application or the DLL that the heap belongs to.

dwResvd

Reserved; do not use.

th32ProcessID

Identifier of the process to examine. The contents of this member can be used by Win32 API elements.

th32HeapID

Heap identifier in the owning process context. The contents of this member has meaning only to the tool help functions. It is not a handle, nor is it usable by Win32 API elements.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in tlhelp32.h.

See Also

Tool Help Library Overview, Tool Help Structures