Método ICLRTask::SetTaskIdentifier

Artigo
08/25/2010

Instrui o Common linguagem tempo de execução (CLR) para associar o valor do identificador especificado tarefa representada pelo corrente ICLRTask instância.

HRESULT SetTaskIdentifier (
    [in] DWORD Asked
);

Parâmetros

Asked
[in] O identificador exclusivo para o Common linguagem tempo de execução para associar a tarefa representada pelo corrente ICLRTask instância.

Valor de retorno

HRESULT	Descrição
S_OK	SetTaskIdentifier retornado com êxito.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.
HOST_E_TIMEOUT	A telefonar expirou.
HOST_E_NOT_OWNER	O chamador não é proprietário do bloquear.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem 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 sentido para o CLR. O CLR passa-junto a um aplicativo do depurador. O depurador pode usar esse identificador para associar um CLR telefonar pilha com um host telefonar empilhar e ativar suas informações de rastreamento respectivos unificado de quando visualizada em interface do usuário do depurador.