Partager via


ICLRGCManager::Collect, méthode

Force un garbage collection pour la génération spécifiée.

Syntaxe

HRESULT Collect (  
    [in] LONG Generation  
);  

Paramètres

Generation
[in] Génération à collecter. Une valeur de -1 force une collecte de toutes les générations.

Valeur de retour

HRESULT Description
S_OK Collect retourné.
HOST_E_CLRNOTAVAILABLE Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel avec succès.
HOST_E_TIMEOUT L’appel a expiré.
HOST_E_NOT_OWNER L’appelant n’est pas propriétaire du verrou.
HOST_E_ABANDONED Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait.
E_FAIL Une défaillance catastrophique inconnue s’est produite. Après qu’une méthode retourne E_FAIL, le CLR n’est plus utilisable dans le processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE.

Notes

La méthode Collect force le garbage collector du CLR à effectuer une collecte quel que soit son état actuel.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponible depuis la version 2.0

Voir aussi