IHostMAlloc::Alloc metódus

Azt kéri, hogy a gazdagép foglalja le a megadott mennyiségű memóriát a heapból.

Szintaxis

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

Paraméterek

cbSize
[in] Az aktuális memóriafoglalási kérelem mérete bájtban.

dwCriticalLevel
[in] Az egyik EMemoryCriticalLevel érték, amely egy foglalási hiba hatását jelzi.

ppMem
[kifelé] Mutató a lefoglalt memóriára, vagy null értékű, ha a kérés nem hajtható végre.

Visszatérési érték

HRESULT	Description
S_OK	Alloc sikeresen visszaadott.
HOST_E_CLRNOTAVAILABLE	A közös nyelvi futtatókörnyezet (CLR) nincs betöltve egy folyamatba, vagy a CLR olyan állapotban van, amelyben nem tudja futtatni a felügyelt kódot, vagy nem tudja sikeresen feldolgozni a hívást.
HOST_E_TIMEOUT	A hívás túllépte az időkorlátot.
HOST_E_NOT_OWNER	A hívó nem rendelkezik a zárral.
HOST_E_ABANDONED	Egy esemény megszakadt, miközben egy blokkolt szál vagy szál várakozott rá.
E_FAIL	Ismeretlen katasztrofális hiba történt. Amikor egy metódus E_FAIL ad vissza, a CLR már nem használható a folyamaton belül. Az üzemeltetési módszerekre irányuló későbbi hívások HOST_E_CLRNOTAVAILABLE adnak vissza.
E_OUTOFMEMORY	Nem volt elég memória a foglalási kérelem befejezéséhez.

Megjegyzések

A CLR az IHostMemoryManager::CreateMalloc metódus meghívásával kap egy felületmutatót egy IHostMalloc példányhoz.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: MSCorEE.h

Könyvtár: Erőforrásként szerepel a MSCorEE.dll

.NET-keretrendszer verziók: 2.0 óta érhető el

Lásd még

• IHostMemoryManager felület
• IHostMalloc felület