Método de ICLRTask::SwitchIn

Artigo
08/08/2011

Notifica o common language runtime (CLR) que a tarefa que o atual ICLRTask instância representa agora está em um estado operável.

HRESULT SwitchIn (
    [in] HANDLE threadHandle
);

Parâmetros

threadHandle
[in] Um identificador para o segmento físico no qual a tarefa, representado pelo atual ICLRTask instância está em execução.

Valor de retorno

HRESULT	Descrição
S_OK	SwitchInretornado com êxito.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada foi esgotado.
HOST_E_NOT_OWNER	O chamador não possui o bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.
HOST_E_INVALIDOPERATION	SwitchInfoi chamado sem uma chamada anterior a Método de ICLRTask::SwitchOut.

Comentários

O threadHandle parâmetro representa um identificador de thread do sistema operacional no qual a tarefa, representado pelo atual ICLRTask instância foi agendada. Se a representação ocorreu neste segmento, você deve chamar IHostSecurityManager::RevertToSelf antes de alternar na tarefa.

Observação

Uma chamada para SwitchIn sem uma anterior, chamada SwitchOut Falha com um valor de HRESULT de HOST_E_INVALIDOPERATION.