Condividi tramite


Metodo ICLRGCManager::Collect

Forza una 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

Oggetto di 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.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

Vedere anche

Riferimenti

Interfaccia ICLRControl

Interfaccia ICLRGCManager

Concetti

Gestione automatica della memoria

Garbage Collection

Altre risorse

Interfacce di hosting per .NET Framework 2.0

Interfacce di hosting

Hosting (riferimenti alle API non gestite)