ICLRTask::SetTaskIdentifier (Método)

Artículo
08/10/2011

Indica a Common Language Runtime (CLR) que asocie el valor del identificador especificado a la tarea representada por la instancia de ICLRTask actual.

HRESULT SetTaskIdentifier (
    [in] DWORD Asked
);

Parámetros

Asked
[in] Identificador único para Common Language Runtime que se va a asociar a la tarea representada por la instancia de ICLRTask actual.

Valor devuelto

HRESULT	Descripción
S_OK	SetTaskIdentifier finalizó correctamente.
HOST_E_CLRNOTAVAILABLE	CLR no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven 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 la aplicación del depurador. El depurador puede utilizar este identificador para asociar una pila de llamadas de CLR a una pila de llamadas del host, permitiendo la unificación de su información de seguimiento respectiva cuando se ve en la interfaz de usuario del depurador.