IHostMAlloc::Alloc 方法

要求主機從堆積配置指定的記憶體數量。

語法

HRESULT Alloc (  
    [in] SIZE_T  cbSize,
    [in] EMemoryCriticalLevel dwCriticalLevel,
    [out] void** ppMem  
);

cbSize
[in] 目前記憶體配置要求的大小 (以位元組為單位)。

dwCriticalLevel
[in] 其中一個 EMemoryCriticalLevel 值，表示配置失敗的影響。

ppMem
[out] 已配置記憶體的指標，如果無法完成要求，則為 null。

HRESULT	描述
S_OK	`Alloc` 已成功傳回。
HOST_E_CLRNOTAVAILABLE	通用語言執行平台 (CLR) 尚未載入處理序，或 CLR 處於無法成功執行受控程式碼或處理呼叫的狀態。
HOST_E_TIMEOUT	呼叫逾時。
HOST_E_NOT_OWNER	呼叫端未擁有鎖定。
HOST_E_ABANDONED	封鎖的執行緒或 Fiber 在其上等候時，事件遭到取消。
E_FAIL	發生未知的重大失敗。如果方法傳回 E_FAIL，則 CLR 就無法再用於處理序。後續對裝載方法發出的呼叫會傳回 HOST_E_CLRNOTAVAILABLE。
E_OUTOFMEMORY	記憶體不足，無法完成配置要求。

CLR 會呼叫 IHostMemoryManager::CreateMalloc 方法，以取得 IHostMalloc 的介面指標。

平台：請參閱系統需求。

標題： MSCorEE.h

程式庫：包含作為 MSCorEE.dll 中的資源

.NET Framework版本：自 2.0 起提供