Classe CLocalHeap

Essa classe implementa IAtlMemMgr usando as funções de heap locais do Win32.

Importante

Essa classe e os respectivos membros não podem ser usados em aplicativos executados no Windows Runtime.

Sintaxe

class CLocalHeap : public IAtlMemMgr

Membros

Métodos públicos

Nome	Descrição
CLocalHeap::Allocate	Chame esse método para alocar um bloco de memória.
CLocalHeap::Free	Chame esse método para liberar um bloco de memória alocado por esse gerenciador de memória.
CLocalHeap::GetSize	Chame esse método para ter o tamanho alocado de um bloco de memória alocado por esse gerenciador de memória.
CLocalHeap::Reallocate	Chame esse método para realocar a memória alocada por esse gerenciador de memória.

Comentários

CLocalHeap implementa funções de alocação de memória usando as funções de heap locais do Win32.

Observação

As funções de heap locais são mais lentas do que outras funções de gerenciamento de memória e não fornecem tantos recursos. Portanto, novos aplicativos devem usar as funções de heap. Eles estão disponíveis na classe CWin32Heap.

Exemplo

Consulte o exemplo de IAtlMemMgr.

Hierarquia de herança

IAtlMemMgr

CLocalHeap

Requisitos

Cabeçalho: atlmem.h

CLocalHeap::Allocate

Chame esse método para alocar um bloco de memória.

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

Parâmetros

nBytes
O número solicitado de bytes no novo bloco de memória.

Valor de Devolução

Retorna um ponteiro para o início do bloco de memória recém-alocado.

Comentários

Chame CLocalHeap::Free ou CLocalHeap::Reallocate para liberar a memória alocada por esse método.

Implementado usando LocalAlloc com um parâmetro de sinalizador de LMEM_FIXED.

CLocalHeap::Free

Chame esse método para liberar um bloco de memória alocado por esse gerenciador de memória.

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

Parâmetros

p
Ponteiro para a memória alocada anteriormente por esse gerenciador de memória. NULL é um valor válido e não faz nada.

Comentários

Implementado usando LocalFree.

CLocalHeap::GetSize

Chame esse método para ter o tamanho alocado de um bloco de memória alocado por esse gerenciador de memória.

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

Parâmetros

p
Ponteiro para a memória alocada anteriormente por esse gerenciador de memória.

Valor de Devolução

Retorna o tamanho do bloco de memória alocado em bytes.

Comentários

Implementado usando LocalSize.

CLocalHeap::Reallocate

Chame esse método para realocar a memória alocada por esse gerenciador de memória.

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

Parâmetros

p
Ponteiro para a memória alocada anteriormente por esse gerenciador de memória.

nBytes
O número solicitado de bytes no novo bloco de memória.

Valor de Devolução

Retorna um ponteiro para o início do bloco de memória recém-alocado.

Comentários

Chame CLocalHeap::Free para liberar a memória alocada por esse método.

Implementado usando LocalReAlloc.

Confira também

Visão geral da classe
Classe CComHeap
Classe CWin32Heap
Classe CGlobalHeap
Classe de CCRTHeap
Classe IAtlMemMgr