Condividi tramite

Metodo IHostMAlloc::Alloc

  • Articolo

Richiede che l'host allochi la quantità di memoria specificata dall'heap.

Sintassi

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

Parametri

cbSize
[in] Dimensione, in byte, della richiesta di allocazione di memoria corrente.

dwCriticalLevel
[in] Uno dei valori EMemoryCriticalLevel , che indica l'impatto di un errore di allocazione.

ppMem
[out] Puntatore alla memoria allocata o Null se non è stato possibile completare la richiesta.

Valore restituito

HRESULT Descrizione
S_OK Alloc restituito correttamente.
HOST_E_CLRNOTAVAILABLE Common Language Runtime (CLR) non è stato caricato in un processo oppure CLR si trova in uno stato in cui non è possibile eseguire codice gestito o elaborare correttamente la chiamata.
HOST_E_TIMEOUT Timeout della chiamata.
HOST_E_NOT_OWNER Il chiamante non possiede il blocco.
HOST_E_ABANDONED Un evento è stato annullato durante l'attesa di un thread o di una fibra bloccata.
E_FAIL Si è verificato un errore irreversibile sconosciuto. Quando un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY Memoria insufficiente per completare la richiesta di allocazione.

Commenti

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

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile dalla versione 2.0

Vedi anche