CoTaskMemAlloc 函式 (combaseapi.h)

以 IMalloc：：Alloc 相同的方式配置工作記憶體區塊。

語法

LPVOID CoTaskMemAlloc(
  [in] SIZE_T cb
);

[in] cb

要配置的記憶體區塊大小，以位元組為單位。

如果函式成功，它會傳回配置的記憶體區塊。否則，它會傳回 NULL。

CoTaskMemAlloc 使用預設配置器，以與 IMalloc：：Alloc 相同的方式配置記憶體區塊。呼叫 CoTaskMemAlloc 之前，不需要呼叫 CoGetMalloc 函式。

未定義傳回記憶體區塊的初始內容 – 不保證已初始化區塊。配置區塊可能會大於 cb 位元組，因為對齊和維護資訊所需的空間。

如果 cb 為 0，CoTaskMemAlloc 會配置零長度的專案，並傳回該專案的有效指標。如果記憶體不足， CoTaskMemAlloc 會傳回 NULL。即使要求少量的記憶體，應用程式也應該一律檢查此函式的傳回值，因為不保證會配置記憶體。

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	combaseapi.h (包含 Objbase.h)
程式庫	Ole32.lib
Dll	Ole32.dll