Partager via


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

Référence

ICLRControl

ICLRGCManager

Autres ressources

Garbage collection

Hébergement du Common Language Runtime