Metodo IHostMAlloc::Alloc

Richiede all'host di allocare dall'heap la quantità di memoria specificata.

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

Parametri

cbSize
[in] Dimensione, in byte, della richiesta corrente di allocazione della memoria.
dwCriticalLevel
[in] Uno dei valori di EMemoryCriticalLevel, che indica l'impatto di un'allocazione non riuscita.
ppMem
[out] Puntatore alla memoria allocata oppure null se non è stato possibile completare la richiesta.

HRESULT	Oggetto di descrizione
S_OK	Alloc ha restituito correttamente un valore.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non è il proprietario del blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Memoria insufficiente per completare la richiesta di allocazione.

Il CLR ottiene un puntatore a interfaccia per un'istanza di IHostMalloc chiamando il metodo IHostMemoryManager::CreateMalloc.

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: inclusa come risorsa in MSCorEE.dll

Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0