Compartir a través de


ICLRTaskManager::CreateTask (Método)

Solicita explícitamente que Common Language Runtime (CLR) cree una nueva tarea.

HRESULT CreateTask (
    [out] ICLRTask **pTask
);

Parámetros

  • pTask
    [out] Puntero a la dirección de una instancia de ICLRTask creada recientemente o NULL si la tarea no pudiera crearse.

Valor devuelto

HRESULT

Descripción

S_OK

El método se devolvió 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.

E_OUTOFMEMORY

No se dispone de memoria suficiente para asignar el recurso solicitado.

Comentarios

CLR crea automáticamente una nueva tarea en la inicialización, cuando el código de usuario crea un subproceso utilizando los tipos del espacio de nombres System.Threading o cuando 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 solicitar explícitamente que CLR cree una nueva tarea. Por ejemplo, el host puede invocar este método para preinicializar las estructuras de datos.

Nota importanteImportante

La nueva tarea se devuelve en estado suspendido y permanece en dicho estado hasta que el host llama explícitamente a IHostTask::Start.

Requisitos

Plataformas: vea Requisitos de sistema de .NET Framework.

Encabezado: MSCorEE.h

Biblioteca: Se incluye como recurso en MsCorEE.dll

Versiones de .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vea también

Referencia

ICLRTask (Interfaz)

ICLRTaskManager (Interfaz)

IHostTask (Interfaz)

IHostTaskManager (Interfaz)