Share via


HEAPENTRY32 (Windows Embedded CE 6.0)

1/6/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

Header tlhelp32.h
Windows Embedded CE Windows CE 1.0 and later

See Also

Reference

ToolHelp Structures
Heap32First