IHostGCManager::ThreadIsBlockingForSuspension, méthode

Article
08/10/2011

Avertit l'hôte que le thread duquel l'appel de méthode a été fait va se bloquer pour un garbage collection.

HRESULT ThreadIsBlockingForSuspension ();

Valeur de retour

HRESULT	Description
S_OK	ThreadIsBlockingForSuspension a été retourné avec succès.
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

Le CLR appelle généralement la méthode ThreadIsBlockForSuspension en préparation d'un garbage collection, pour donner à l'hôte une occasion de replanifier le thread pour les tâches non managées.

Important
L'hôte peut replanifier des tâches uniquement après un appel à ThreadIsBlockingForSuspension.Une fois que le runtime a appelé SuspensionStarting, l'hôte ne doit pas replanifier de tâche.