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