Método de IHostMAlloc::Alloc

Solicitações que o host alocar a quantidade especificada de memória do heap.

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

Parâmetros

cbSize
[in] O tamanho em bytes, a solicitação de alocação de memória atual.
dwCriticalLevel
[in] Dentre as EMemoryCriticalLevel valores, indicando o impacto de uma falha de alocação.
ppMem
[out] Um ponteiro para a memória alocada ou nulo se a solicitação não pôde ser concluída.

HRESULT	Descrição
S_OK	Allocretornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common language runtime (CLR) não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada foi esgotado.
HOST_E_NOT_OWNER	O chamador não possui o bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Não havia memória disponível suficiente para concluir a solicitação de alocação.

O CLR obtém um ponteiro de interface para um IHostMalloc instância chamando o IHostMemoryManager::CreateMalloc método.

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: MSCorEE.h

Biblioteca: Incluído como um recurso em mscoree

.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0