Delen via


Methode IHostMAlloc::Alloc

Vraagt dat de host de opgegeven hoeveelheid geheugen van de heap toewijst.

Syntaxis

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

Parameters

cbSize
[in] De grootte, in bytes, van de huidige aanvraag voor geheugentoewijzing.

dwCriticalLevel
[in] Een van de EMemoryCriticalLevel-waarden , die de impact van een toewijzingsfout aangeeft.

ppMem
[uit] Een aanwijzer naar het toegewezen geheugen of null als de aanvraag niet kan worden voltooid.

Retourwaarde

HRESULT Beschrijving
S_OK Alloc is geretourneerd.
HOST_E_CLRNOTAVAILABLE De COMMON Language Runtime (CLR) is niet geladen in een proces of de CLR heeft een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt.
HOST_E_TIMEOUT Er is een time-out opgetreden voor het gesprek.
HOST_E_NOT_OWNER De beller is niet de eigenaar van het slot.
HOST_E_ABANDONED Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of glasvezel op wachtte.
E_FAIL Er is een onbekende catastrofale fout opgetreden. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY Er was onvoldoende geheugen beschikbaar om de toewijzingsaanvraag te voltooien.

Opmerkingen

De CLR haalt een interfaceaanwijzer op naar een IHostMalloc exemplaar door de methode IHostMemoryManager::CreateMalloc aan te roepen.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 2.0

Zie ook