ICLRGCManager::Collect, méthode
Mise à jour : novembre 2007
Force un garbage collection pour la génération spécifiée.
HRESULT Collect (
[in] LONG Generation
);
Paramètres
- Generation
[in] Génération à collecter. Une valeur de -1 force une collection de toutes les générations.
Valeur de retour
HRESULT |
Description |
---|---|
S_OK |
Collect a été retourné correctement. |
HOST_E_CLRNOTAVAILABLE |
Le Common Language Runtime (CLR) n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès. |
HOST_E_TIMEOUT |
L'appel a expiré. |
HOST_E_NOT_OWNER |
L'appelant ne possède pas le verrou. |
HOST_E_ABANDONED |
Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait. |
E_FAIL |
Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE. |
Notes
La méthode Collect oblige le garbage collector du CLR à exécuter une collection indépendamment de son état actuel.
Configuration requise
Plateformes : consultez Configuration requise du .NET Framework.
En-tête : MSCorEE.idl
Bibliothèque : incluse en tant que ressource dans MSCorEE.dll
Versions du .NET Framework : 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0
Voir aussi
Concepts
Gestion automatique de la mémoire