HEAPENTRY32
A version of this page is also available for
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
| Header | tlhelp32.h |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |