CLocalHeap 類別

這個類別會使用 Win32 本機堆積函式來實作 IAtlMemMgr 。

重要

這個類別及其成員不能用於在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 類別