ICLRTaskManager::CreateTask (Método)

Actualización: noviembre 2007

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.