IHostTaskManager::CreateTask (Método)

Artículo
08/10/2011

Solicita que el host cree una nueva tarea.

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 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 del usuario que se van a pasar a la función, o null si la función no toma ningún parámetro.
ppTask
[out] Puntero a la dirección de una instancia de IHostTask creada por el host, o null si no se puede crear la tarea. La tarea permanece en estado suspendido hasta que es iniciada explícitamente por una llamada a IHostTask::Start.

Valor devuelto

HRESULT	Descripción
S_OK	CreateTask finalizó correctamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (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 había suficiente memoria disponible para crear la tarea solicitada.

Comentarios

CLR llama a CreateTask para solicitar al host que cree una nueva tarea. El host devuelve un puntero de interfaz a una instancia de IHostTask. La tarea devuelta debe permanecer suspendida hasta que la inicia explícitamente una llamada a IHostTask::Start.