Класс CLocalHeap

Этот класс реализует IAtlMemMgr с помощью функций локальной кучи Win32.

Важно!

Этот класс и его члены нельзя использовать в приложениях, выполняемых в среде выполнения Windows.

Синтаксис

class CLocalHeap : public IAtlMemMgr

Участники

Открытые методы

Имя	Описание
CLocalHeap::Allocate	Вызовите этот метод, чтобы выделить блок памяти.
CLocalHeap::Free	Вызовите этот метод, чтобы освободить блок памяти, выделенный этим диспетчером памяти.
CLocalHeap::GetSize	Вызовите этот метод, чтобы получить выделенный размер блока памяти, выделенного этим диспетчером памяти.
CLocalHeap::Reallocate	Вызовите этот метод для перераспределения памяти, выделенной данным диспетчером памяти.

Замечания

CLocalHeap реализует функции выделения памяти с помощью функций локальной кучи Win32.

Примечание.

Функции локальной кучи медленнее, чем другие функции управления памятью и не предоставляют столько функций. Поэтому новые приложения должны использовать функции кучи. Они доступны в классе CWin32Heap .

Пример

См. пример для IAtlMemMgr.

Иерархия наследования

IAtlMemMgr

CLocalHeap

Требования

Заголовок: atlmem.h

CLocalHeap::Allocate

Вызовите этот метод, чтобы выделить блок памяти.

virtual __declspec(allocator) void* Allocate(size_t nBytes) throw();

Параметры

nBytes
Запрошенное число байтов в новом блоке памяти.

Возвращаемое значение

Возвращает указатель на начало выделенного блока памяти.

Замечания

Вызовите CLocalHeap::Free или CLocalHeap::Reallocate , чтобы освободить память, выделенную этим методом.

Реализовано с помощью LocalAlloc с параметром флага LMEM_FIXED.

CLocalHeap::Free

Вызовите этот метод, чтобы освободить блок памяти, выделенный этим диспетчером памяти.

virtual void Free(void* p) throw();

Параметры

p
Указатель на область памяти, выделенную ранее данным диспетчером памяти. NULL является допустимым значением и ничего не делает.

Замечания

Реализовано с помощью LocalFree.

CLocalHeap::GetSize

Вызовите этот метод, чтобы получить выделенный размер блока памяти, выделенного этим диспетчером памяти.

virtual size_t GetSize(void* p) throw();

Параметры

p
Указатель на область памяти, выделенную ранее данным диспетчером памяти.

Возвращаемое значение

Возвращает размер выделенного блока памяти в байтах.

Замечания

Реализовано с помощью LocalSize.

CLocalHeap::Reallocate

Вызовите этот метод для перераспределения памяти, выделенной данным диспетчером памяти.

virtual __declspec(allocator) void* Reallocate(void* p, size_t nBytes) throw();

Параметры

p
Указатель на область памяти, выделенную ранее данным диспетчером памяти.

nBytes
Запрошенное число байтов в новом блоке памяти.

Возвращаемое значение

Возвращает указатель на начало выделенного блока памяти.

Замечания

Вызовите CLocalHeap::Free , чтобы освободить память, выделенную этим методом.

Реализовано с помощью LocalReAlloc.

См. также

Общие сведения о классе
Класс CComHeap
Класс CWin32Heap
Класс CGlobalHeap
Класс CCRTHeap
Класс IAtlMemMgr