Sdílet prostřednictvím

IHostMAlloc::Alloc – metoda

  • Článek

Požaduje, aby hostitel přidělil zadané množství paměti z haldy.

Syntaxe

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

Parametry

cbSize
[v] Velikost aktuálního požadavku na přidělení paměti v bajtech.

dwCriticalLevel
[v] Jedna z hodnot EMemoryCriticalLevel označující dopad selhání přidělení.

ppMem
[out] Ukazatel na přidělenou paměť nebo null, pokud požadavek nelze dokončit.

Návratová hodnota

HRESULT Description
S_OK Alloc úspěšně vráceno.
HOST_E_CLRNOTAVAILABLE Modul CLR (Common Language Runtime) nebyl načten do procesu nebo je ve stavu, ve kterém nemůže spustit spravovaný kód nebo úspěšně zpracovat volání.
HOST_E_TIMEOUT Časový limit hovoru vypršel.
HOST_E_NOT_OWNER Volající zámek nevlastní.
HOST_E_ABANDONED Událost byla zrušena, když na ni čekalo blokované vlákno nebo vlákno.
E_FAIL Došlo k neznámému katastrofickému selhání. Když metoda vrátí E_FAIL, CLR už není v rámci procesu použitelný. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY K dokončení žádosti o přidělení nebylo k dispozici dostatek paměti.

Poznámky

CLR získá ukazatel rozhraní na IHostMalloc instanci voláním metody IHostMemoryManager::CreateMalloc .

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: MSCorEE.h

Knihovny: Zahrnuto jako prostředek v MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 2.0

Viz také