HEAPENTRY32

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure describes one entry, or block, of a heap that is being examined.

Syntax

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
  Length, in bytes, of the structure.

  Before calling the Heap32First function, set this member to sizeof(HEAPENTRY32).

  If you do not initialize dwSize, Heap32First fails.

• hHandle
  Handle to the heap block.

• dwAddress
  Linear address of the start of the block.

• dwBlockSize
  Size, in bytes, of the heap block.

• dwFlags
  Bitmask of flags.

  The following table shows available values for this parameter.

  Value	Description
  LF32_BIGBLOCK	A large piece of memory that has been virtually allocated.
  LF32_DECOMMIT	A decommited memory block.
  LF32_FIXED	A memory block with a fixed, or unmovable, location.
  LF32_FREE	A memory block that is not used.

• dwLockCount
  Lock count on the memory block.

  The lock count is incremented each time the LocalLock function is called on the block by the application or by 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 content of this member has meaning only to the tool help functions.

  This member is not a handle, nor is it usable by Win32 API elements.

Remarks

Windows Embedded CE does not support movable blocks.

Requirements

See Also

Reference

ToolHelp Structures
Heap32First