Método ICLRTask::SetTaskIdentifier
Instrui o runtime de linguagem comum (CLR) a associar o valor do identificador especificado à tarefa representada pela instância ICLRTask atual.
Sintaxe
HRESULT SetTaskIdentifier (
[in] DWORD Asked
);
Parâmetros
Asked
[in] O identificador exclusivo do runtime de linguagem comum a associar à tarefa representada pela instância atual ICLRTask .
Devolver Valor
| HRESULT | Description |
|---|---|
| S_OK | SetTaskIdentifier devolvido com êxito. |
| HOST_E_CLRNOTAVAILABLE | O CLR não foi carregado para um processo ou o CLR está num estado em que não pode executar o código gerido ou processar a chamada com êxito. |
| HOST_E_TIMEOUT | A chamada excedeu o limite de tempo. |
| HOST_E_NOT_OWNER | O autor da chamada não é o proprietário do bloqueio. |
| HOST_E_ABANDONED | Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera. |
| E_FAIL | Ocorreu uma falha catastrófica desconhecida. Quando um método devolve E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE. |
Observações
O anfitrião pode associar um identificador a uma tarefa para ajudar a integrar o CLR e o anfitrião num ambiente de depuração. O identificador não tem significado para o CLR. O CLR transmite-o para uma aplicação de depurador. O depurador pode utilizar este identificador para associar uma pilha de chamadas CLR a uma pilha de chamadas de anfitrião e permitir que as respetivas informações de rastreio sejam unificadas quando visualizadas na interface de utilizador do depurador.
Requisitos
Plataformas: Veja Requisitos de Sistema.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso no MSCorEE.dll
.NET Framework Versões: Disponível desde 2.0
