Метод 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	Событие было отменено во время ожидания заблокированного потока или волокна.
E_FAIL	Произошла неизвестная катастрофическая ошибка. Когда метод возвращает E_FAIL, среда CLR больше не поддерживается в процессе. Последующие вызовы методов размещения возвращают HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Недостаточно памяти для выполнения запроса на выделение.

Комментарии

Среда CLR получает указатель интерфейса на IHostMalloc экземпляр, вызывая метод IHostMemoryManager::CreateMalloc .

Требования

Платформы: см. раздел Требования к системе.

Заголовка: MSCorEE.h

Библиотека: Включено в качестве ресурса в MSCorEE.dll

версии платформа .NET Framework: доступно с версии 2.0

См. также раздел

• Интерфейс IHostMemoryManager
• Интерфейс IHostMalloc