CWin32Heap Class

This class implements IAtlMemMgr using the Win32 heap allocation functions.

Important

This class and its members cannot be used in applications that execute in the Windows Runtime.

class CWin32Heap : public IAtlMemMgr

Members

Public Constructors

Name

Description

CWin32Heap::CWin32Heap

The constructor.

CWin32Heap::~CWin32Heap

The destructor.

Public Methods

Name

Description

CWin32Heap::Allocate

Allocates a block of memory from the heap object.

CWin32Heap::Attach

Attaches the heap object to an existing heap.

CWin32Heap::Detach

Detaches the heap object from an existing heap.

CWin32Heap::Free

Frees memory previously allocated from the heap.

CWin32Heap::GetSize

Returns the size of a memory block allocated from the heap object.

CWin32Heap::Reallocate

Reallocates a block of memory from the heap object.

Public Data Members

Name

Description

CWin32Heap::m_bOwnHeap

A flag used to determine current ownership of the heap handle.

CWin32Heap::m_hHeap

Handle to the heap object.

Remarks

CWin32Heap implements memory allocation methods using the Win32 heap allocation functions, including HeapAlloc and HeapFree. Unlike other Heap classes, CWin32Heap requires a valid heap handle to be provided before memory is allocated: the other classes default to using the process heap. The handle can be supplied to the constructor or to the CWin32Heap::Attach method. See the CWin32Heap::CWin32Heap method for more details.

Example

See the example for IAtlMemMgr.

Inheritance Hierarchy

IAtlMemMgr

CWin32Heap

Requirements

Header: atlmem.h

See Also

Reference

IAtlMemMgr Class

CLocalHeap Class

CGlobalHeap Class

CCRTHeap Class

CComHeap Class

Other Resources

ATL Class Overview