Método de ICLRTask::SetTaskIdentifier

Artigo
08/08/2011

Instrui o common language runtime (CLR) para associar o valor do identificador especificado a tarefa representada pela atual ICLRTask instância.

HRESULT SetTaskIdentifier (
    [in] DWORD Asked
);

Parâmetros

Asked
[in] O identificador exclusivo para o common language runtime associar a tarefa representada pela atual ICLRTask instância.

Valor de retorno

HRESULT	Descrição
S_OK	SetTaskIdentifierretornado 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.

Comentários

O host pode associar um identificador de uma tarefa para ajudar a integrar o CLR e o host em um ambiente de depuração. O identificador não tem significado para o CLR. O CLR passa para um aplicativo do depurador. O depurador pode usar esse identificador para associar a uma pilha de chamadas de host de uma pilha de chamadas CLR e ativar suas informações de rastreamento respectivos para Unificação de quando visualizado na interface do usuário do depurador.