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 |