Condividi tramite


Metodo ICLRGCManager::Collect

Aggiornamento: novembre 2007

Forza un Garbage Collection per la generazione specificata.

HRESULT Collect (
    [in] LONG Generation
);

Parametri

  • Generation
    [in] Generazione su cui effettuare una Garbage Collection. Il valore -1 impone l'esecuzione della Garbage Collection su tutte le generazioni.

Valore restituito

HRESULT

Descrizione

S_OK

Collect 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.

Note

Il metodo Collect forza il Garbage Collector di Common Language Runtime a eseguire un Garbage Collection indipendentemente dallo stato corrente.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.idl

Libreria: inclusa come risorsa in MSCorEE.dll

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

Vedere anche

Concetti

Gestione automatica della memoria

Riferimenti

ICLRControl

ICLRGCManager

Altre risorse

Garbage Collection

Hosting di Common Language Runtime