HEAPENTRY32

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

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

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:

Value	Meaning
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.

Requirements

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

See Also

Tool Help Library Overview, Tool Help Structures, , Heap32First