Compartilhar via


Método IHostMAlloc::Alloc

Solicitações que o host de 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 dimensionar, em bytes, a solicitação de alocação de memória corrente.

  • dwCriticalLevel
    [in] Um do 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.

Valor de retorno

HRESULT

Descrição

S_OK

Alloc retornado com êxito.

HOST_E_CLRNOTAVAILABLE

O common linguagem tempo de execução (CLR) não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.

HOST_E_TIMEOUT

A telefonar expirou.

HOST_E_NOT_OWNER

O chamador não é proprietário do bloquear.

HOST_E_ABANDONED

Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.

E_FAIL

Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem métodos retornam HOST_E_CLRNOTAVAILABLE.

E_OUTOFMEMORY

Não há memória insuficiente concluir a solicitação de alocação.

Comentários

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

Requisitos

Plataformas: See Requisitos de sistema do .NET framework.

Cabeçalho: MSCorEE.idl

Biblioteca: Incluído sistema autônomo um recurso em MSCorEE.dll

.NET Framework Versions: 3.5 SP1, 3,5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Referência

Interface IHostMemoryManager

Interface IHostMAlloc