CHeapPtrList Class
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at CHeapPtrList Class.
This class provides methods useful when constructing a list of heap pointers.
Important
This class and its members cannot be used in applications that execute in the Windows Runtime.
Syntax
template<typename E, class Allocator = ATL::CCRTAllocator>
class CHeapPtrList
: public CAtlList<ATL::CHeapPtr<E, Allocator>,
CHeapPtrElementTraits<E, Allocator>>
Parameters
E
The object type to be stored in the collection class.
Allocator
The memory allocation class to use. The default is CCRTAllocator.
Members
Public Constructors
| Name | Description |
|---|---|
| CHeapPtrList::CHeapPtrList | The constructor. |
Remarks
This class provides a constructor and derives methods from CAtlList and CHeapPtrElementTraits to aid the creation of a collection class object storing heap pointers.
Inheritance Hierarchy
CHeapPtrList
Requirements
Header: atlcoll.h
CHeapPtrList::CHeapPtrList
The constructor.
CHeapPtrList(UINT nBlockSize = 10) throw();
Parameters
nBlockSize
The block size.
Remarks
The block size is a measure of the amount of memory allocated when a new element is required. Larger block sizes reduce calls to memory allocation routines, but use more resources.
See Also
CAtlList Class
CHeapPtr Class
CHeapPtrElementTraits Class
Class Overview