Metodo IHostGCManager::ThreadIsBlockingForSuspension

Articolo
08/11/2011

Notifica all'host che il thread da cui è stata effettuata la chiamata al metodo sta per essere bloccato per l'esecuzione della Garbage Collection.

HRESULT ThreadIsBlockingForSuspension ();

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	ThreadIsBlockingForSuspension 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

Common Language Runtime in genere chiama il metodo ThreadIsBlockForSuspension in preparazione a un Garbage Collection, in modo da consentire all'host di ripianificare il thread per le attività non gestite.

Importante
L'host può eseguire la ripianificazione delle attività solo dopo una chiamata a ThreadIsBlockingForSuspension.Una volta chiamato SuspensionStarting, l'host non dovrà ripianificare un'attività.