ICLRTaskManager::CreateTask (Método)
Solicita explícitamente que Common Language Runtime (CLR) cree una nueva tarea.
Sintaxis
HRESULT CreateTask (
[out] ICLRTask **pTask
);
Parámetros
pTask
[out] Puntero a la dirección de un ICLRTask recién creado, o null, si no se pudo crear la tarea.
Valor devuelto
| HRESULT | Descripción |
|---|---|
| S_OK | El método 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. |
| E_OUTOFMEMORY | No hay suficiente memoria disponible para asignar el recurso solicitado. |
Comentarios
CLR crea automáticamente una nueva tarea tras la inicialización, cuando el código de usuario crea un subproceso mediante tipos en el espacio de nombres System.Threading o cuando se aumenta el tamaño del grupo de subprocesos. También crea tareas cuando el código no administrado realiza una llamada a una función administrada.
CreateTask permite al host realizar una solicitud explícita que el CLR cree una nueva tarea. Por ejemplo, el host puede invocar este método para inicializar previamente las estructuras de datos.
Importante
La nueva tarea se devuelve en un estado suspendido y permanece suspendida hasta que el host llama explícitamente a IHostTask::Start.
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
