IHostTaskManager::CreateTask (Método)
Solicita que el host cree una tarea.
Sintaxis
HRESULT CreateTask (
[in] DWORD stacksize,
[in] LPTHREAD_START_ROUTINE pStartAddress,
[in] PVOID pParameter,
[out] IHostTask **ppTask
);
Parámetros
stacksize
[in] Tamaño solicitado, en bytes, de la pila solicitada, o bien 0 (cero) para el tamaño predeterminado.
pStartAddress
[in] Puntero a la función que va a ejecutar la tarea.
pParameter
[in] Puntero a los datos de usuario que se van a pasar a la función, o bien null si la función no toma ningún parámetro.
ppTask
[out] Puntero a la dirección de una instancia de IHostTask que crea el host, o bien null si no se puede crear la tarea. La tarea permanece en un estado suspendido hasta que se inicia explícitamente mediante una llamada a IHostTask::Start.
Valor devuelto
| HRESULT | Descripción |
|---|---|
| S_OK | CreateTask se devolvió correctamente. |
| HOST_E_CLRNOTAVAILABLE | El 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 o 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 | Si se devuelve este valor, significa que no hubo suficiente memoria disponible para crear la tarea solicitada. |
Comentarios
CLR llama a CreateTask para solicitar que el host cree una tarea. El host devuelve un puntero de interfaz a una instancia de IHostTask. La tarea devuelta debe permanecer suspendida hasta que se inicie explícitamente mediante una llamada 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
