ICLRTask::SetTaskIdentifier (Método)
Indica a Common Language Runtime (CLR) que asocie el valor de identificador especificado a la tarea que representa la instancia de ICLRTask actual.
Sintaxis
HRESULT SetTaskIdentifier (
[in] DWORD Asked
);
Parámetros
Asked
[in] Identificador único de Common Language Runtime que se va a asociar a la tarea que representa la instancia de ICLRTask actual.
Valor devuelto
| HRESULT | Descripción |
|---|---|
| S_OK | SetTaskIdentifier se devolvió correctamente. |
| HOST_E_CLRNOTAVAILABLE | Si se devuelve este valor, significa que Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado ni procesar la llamada correctamente. |
| HOST_E_TIMEOUT | Se agotó el tiempo de espera de la llamada. |
| HOST_E_NOT_OWNER | El autor de la llamada no es el propietario del bloqueo. |
| HOST_E_ABANDONED | Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando. |
| E_FAIL | Ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE. |
Comentarios
El host puede asociar un identificador a una tarea para ayudar a integrar CLR y el host en un entorno de depuración. El identificador no tiene ningún significado para CLR. CLR lo pasa a una aplicación del depurador. El depurador puede usar este identificador para asociar una pila de llamadas CLR a una pila de llamadas de host y permitir que su información de seguimiento respectiva se unifique cuando se vea en la interfaz de usuario del depurador.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: MSCorEE.h
Biblioteca: incluida como recurso en MSCorEE.dll
Versiones de .NET Framework: disponible a partir de la versión 2.0
