Método IHostMAlloc::Alloc
Pede que o anfitrião aloque a quantidade especificada de memória da área dinâmica para dados.
Sintaxe
HRESULT Alloc (
[in] SIZE_T cbSize,
[in] EMemoryCriticalLevel dwCriticalLevel,
[out] void** ppMem
);
Parâmetros
cbSize
[in] O tamanho, em bytes, do pedido de alocação de memória atual.
dwCriticalLevel
[in] Um dos valores de EMemoryCriticalLevel , que indica o impacto de uma falha de alocação.
ppMem
[fora] Um ponteiro para a memória alocada ou nulo se não for possível concluir o pedido.
Devolver Valor
HRESULT | Description |
---|---|
S_OK | Alloc devolvido com êxito. |
HOST_E_CLRNOTAVAILABLE | O runtime de linguagem comum (CLR) não foi carregado para um processo ou o CLR está num estado em que não pode executar código gerido ou processar a chamada com êxito. |
HOST_E_TIMEOUT | A chamada excedeu o limite de tempo. |
HOST_E_NOT_OWNER | O autor da chamada não é o proprietário do bloqueio. |
HOST_E_ABANDONED | Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera. |
E_FAIL | Ocorreu uma falha catastrófica desconhecida. Quando um método devolve E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE. |
E_OUTOFMEMORY | Não estava disponível memória suficiente para concluir o pedido de alocação. |
Observações
O CLR obtém um ponteiro de interface para uma IHostMalloc
instância ao chamar o método IHostMemoryManager::CreateMalloc .
Requisitos
Plataformas: Veja Requisitos de Sistema.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso no MSCorEE.dll
.NET Framework Versões: Disponível desde 2.0