This structure describes one entry (block) of a heap that is being examined.
At a Glance
| Header file: | Tlhelp32.h |
| Windows CE versions: | 1.0 and later |
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
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
Specifies the linear address of the start of the block.
dwBlockSize
Specifies the size, in bytes, of the heap block.
dwFlags
Specifies a bitmask of flags. It is one of the following values:
| Value | Description |
| LF32_BIGBLOCK | A large piece of memory that has been virtually allocated. |
| LF32_DECOMMIT | Decommited memory block. |
| LF32_FIXED | The memory block has a fixed (unmovable) location. |
| LF32_FREE | The memory block is not used. |
dwLockCount
Specifies the lock count on the memory block. The lock count is incremented each time the 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.
Remarks
Windows CE does not support movable blocks.